개발자 리소스
다음 시스템을 연결하기 전에, 고객 업무 한 가지가 끝까지 처리되는지 먼저 확인하세요.
승인된 고객 업무 한 가지를 선택하고 인증, 워크스페이스, 권한, 재시도, 오류 처리, 감사 기록을 정한 뒤 API로 연결합니다.
연동 구현 체크리스트
연결할 업무 선택
고객 기록, 처리 사례, 승인된 답변, 직원 인계 중 하나부터 시작하세요.
API 요청 조건 확인
호출할 작업, 권한, 워크스페이스, 서버가 보낼 필드를 기록합니다.
실패 상황 먼저 테스트
권한 없음, 잘못된 요청, 충돌, 호출 제한, 일시적 서비스 오류를 시험합니다.
처리 완료 추적
요청 ID를 보관하고 API 결과 또는 웹훅을 생성된 업무와 연결합니다.
요청과 처리 결과
GET /knowledge/facts
Authorization: Bearer <server-token>
X-Workspace-Id: <workspace-id>HTTP 200
X-Request-Id: req_...
{ "items": [], "nextCursor": null }오류별 대응 방법
| 상태 | 의미 | 연동 측 조치 |
|---|---|---|
| 401 | 인증 정보가 없거나 만료되었거나 올바르지 않음 | 요청을 중지하고 승인된 서버 절차로 인증 정보를 갱신합니다. |
| 403 | 요청한 작업에 필요한 권한 또는 범위가 없음 | 다시 시도하지 말고 접근 권한 검토를 요청합니다. |
| 409 | 상태, 버전, 중복 처리 방지 키, 승인 상태가 충돌함 | 충돌 내용을 확인하고 상태를 맞춘 뒤 다음 요청을 보냅니다. |
| 422 | 요청 형식이 공개된 스키마와 일치하지 않음 | 오류에 표시된 필드를 수정한 뒤 다시 요청합니다. |
| 429 | 짧은 시간에 요청을 너무 많이 보냄 | 응답에 안내된 대기 시간에 맞춰 요청 간격을 늘립니다. |
| 5xx | 일시적인 서비스 오류가 발생했을 수 있음 | 요청 ID를 보관하고 해당 작업이 재시도를 허용할 때만 다시 시도합니다. |