개발자 센터는 Exayard를 사용자의 코드 및 도구와 연결하는 곳입니다. 설정 다음 개발자에서 엽니다. 여기서 API 키를 생성하고, 웹훅 엔드포인트를 등록하며, 모든 API 요청의 실시간 로그를 검토합니다. 이 페이지에는 조직 관리자만 접근할 수 있습니다.
API 키
API 키는 Exayard API에 대한 요청을 인증합니다. 키는 조직에 속하므로 올바른 계정이 자동으로 선택되며 전달할 조직 ID가 없습니다.
자격 증명 카드에서 API 키 탭을 열고 + 버튼을 클릭하세요. 키에 이름을 지정한 다음 범위를 선택하세요. 모든 범위를 부여하려면 전체를, 개별 권한을 선택하려면 특정을 선택하세요. 범위는 리소스별로 읽기와 쓰기로 나뉘며, read:projects와 write:estimates와 같은 형태입니다. admin:org 범위는 전체 접근 권한을 부여합니다. 통합에 필요한 최소한의 범위를 선택하세요.
Exayard는 키를 생성한 직후에 전체 키를 한 번만 표시합니다. 다시는 표시되지 않으므로 그때 복사하세요. 그 후에는 각 키가 이름, ak_••••1234와 같은 마스킹된 미리보기, 마지막 사용 날짜와 함께 표시됩니다.
연필 아이콘을 사용하여 키 이름을 바꾸거나 범위를 변경하세요. 휴지통 아이콘을 사용하여 키를 취소하세요. 취소는 영구적이며, 해당 키를 사용하는 모든 통합이 즉시 작동을 멈춥니다.
동일한 키가 노코드 통합도 인증합니다. Exayard를 Zapier에 연결하기, Exayard를 Make에 연결하기, Exayard를 n8n에 연결하기를 참고하세요. 에이전트 및 AI 편집기 접근은 Claude 및 기타 AI 도구에 연결하기를 참고하세요.
웹훅
웹훅은 어떤 일이 발생할 때 Exayard가 사용자의 서버에 알리도록 지시합니다. 웹훅 탭을 열고 **+**를 클릭하여 엔드포인트를 추가하세요. 전송을 받을 URL과 선택 사항인 설명을 입력하세요.
구독할 이벤트를 선택하세요. 모든 이벤트를 받으려면 전체를, 목록에서 선택하려면 특정을 선택하세요.
이벤트 | 발생 시점 |
| 프로젝트가 생성될 때 |
| 프로젝트가 변경될 때 |
| 프로젝트가 보관될 때 |
| 적산 평가가 시작될 때 |
| 평가가 완료될 때 |
| 평가가 승인될 때 |
| 평가가 취소될 때 |
| 견적이 생성될 때 |
| 입찰이 생성될 때 |
| 업로드된 파일의 처리가 완료될 때 |
엔드포인트를 생성하면 Exayard가 서명 비밀을 한 번만 표시합니다. 다시는 표시되지 않으므로 그때 복사하세요.
웹훅 전송 보안 처리하기
모든 전송에는 t=<unix>,v1=<digest> 형식의 Exayard-Signature 헤더가 포함됩니다. Exayard는 타임스탬프와 요청 본문을 결합한 다음, 엔드포인트 비밀을 사용해 HMAC-SHA256으로 서명하여 시그니처를 만듭니다.
전송을 검증하려면 사용자의 비밀로 시그니처를 다시 계산하고, 타임스탬프가 현재로부터 5분 이내인지 확인한 다음, 다이제스트를 비교하세요. 실패한 전송은 약 3일에 걸쳐 지수 백오프로 재시도됩니다.
엔드포인트를 편집하려면 연필 아이콘을 클릭하세요. URL, 설명, 이벤트를 변경하고, 상태를 활성 또는 일시 중지로 설정할 수 있습니다. 일시 중지된 엔드포인트는 전송 수신을 멈춥니다. 같은 대화 상자에는 비밀 교체 버튼이 있습니다. 교체하면 새 비밀이 발급되고 기존 비밀이 즉시 작동을 멈추므로, 교체하기 전에 서버를 업데이트하세요. 휴지통 아이콘은 엔드포인트를 삭제하고 해당 엔드포인트로의 모든 전송을 종료합니다.
빠른 시작
빠른 시작 카드에는 Claude나 Cursor 같은 AI 편집기를 위한 미리 만들어진 프롬프트가 담겨 있습니다. 프롬프트 복사를 클릭하여 편집기에 붙여넣으세요. 프롬프트에는 API 기본 URL, 인증 형식, 범위 용어, 웹훅 서명 방식이 포함되어 있어 AI가 작동하는 통합의 골격을 만들고 필요한 세부 정보를 사용자에게 요청할 수 있습니다.
문서
문서 카드는 전체 개발자 문서와, 모든 경로와 스키마를 설명하는 OpenAPI 명세로 연결됩니다. MCP 연결은 AI 에이전트를 Exayard에 직접 연결하는 설정을 엽니다.
로그
로그 섹션은 REST API와 MCP 양쪽에 걸쳐 가장 최근의 API 요청을 기록합니다. 각 행은 메서드, 경로, 응답 상태, 지연 시간을 표시합니다. 행을 선택하면 요청 ID와 요청 및 응답 본문을 포함한 전체 세부 정보를 볼 수 있습니다. 로그를 사용하여 호출이 작동했는지 확인하거나 실패하는 통합을 디버깅하세요.
