Machine translation. This page was translated by AI from the English article and has not been reviewed by a person yet. Read the English original
Developer
API 상태 코드: 각 오류의 의미와 해결 방법
모든 RESTful API 응답에는 숫자 StatusCode가 포함됩니다. 코드 0은 성공을 의미합니다. Callback 응답은 다릅니다: 서버는 항상 HTTP 200과 함께 {"status":"done"}으로 응답해야 합니다.
| 코드 | 상태 | 의미 | 조치 |
|---|---|---|---|
| 0 | Success | 작업이 완료되었습니다. | 필요 없음. |
| 1 | Invalid Request Data | JSON 본문의 형식이 잘못되었거나 값이 올바르지 않습니다. | UTF-8 raw JSON을 Content-Type: application/json 헤더와 함께 보내세요. 값을 확인하세요. |
| 2 | Invalid Service Tag ID | stgid 쿼리 매개변수와 일치하는 등록된 기기가 없습니다. | API Monitor 계정에서 Service Tag ID를 다시 복사하세요. |
| 3 | Invalid Request | 요청이 해당 작업의 형식을 따르지 않습니다. | 해당 작업의 샘플 요청과 비교하세요. |
| 4 | Invalid Encryption | AES-256 페이로드를 복호화할 수 없었습니다. | 암호화 키와 Base64 인코딩을 확인하세요. |
| 5 | Device Offline | 대상 기기가 현재 Cams에 연결되어 있지 않습니다. | Device Status 페이지를 확인하세요. 명령은 대기열에 저장되었다가 기기가 다시 연결되면 전달됩니다. |
| 6 | Operation Timeout | 기기가 제때 명령에 응답하지 않았습니다. | 기기가 온라인인지 확인한 후 다시 시도하세요. |
| 7 | Invalid Auth Token | AuthToken이 기기에 설정된 토큰과 일치하지 않습니다. | API Monitor의 32자리 토큰을 사용하세요. |
| 8 | User Already Exists | 이미 기기에 있는 UserID로 추가를 시도했습니다. | 대신 사용자를 업데이트하거나 먼저 사용자를 삭제하세요. |
| 9 | User Not Found | 해당 UserID가 기기에 없습니다. | UserID를 확인하세요. 필요하면 먼저 사용자를 추가하세요. |
| 10 | Template Error | 생체 템플릿이 손상되었거나 지원되지 않는 형식입니다. | 템플릿의 Base64 데이터, Size, Index를 확인하세요. |
| 11 | Device Memory Full | 기기가 사용자 또는 템플릿의 한도에 도달했습니다. | 더 이상 필요 없는 사용자나 템플릿을 삭제하세요. |
| 13 | Invalid Security Key | 보안 키가 API Monitor의 키와 일치하지 않습니다. | 양쪽에서 같은 키를 사용하세요. |
| 15 | Feature Not Supported | 이 기기 모델 또는 연결 모드는 해당 작업을 지원하지 않습니다. | 연결 모드를 확인하세요. DB Pull 및 File Processing 모드는 출퇴근 push만 지원하며 RESTful 명령은 지원하지 않습니다. |
| 999 | Unknown Error | 예기치 않은 오류입니다. | Cams 지원팀에 문의하고 OperationID를 알려 주세요. |
팁
- 각 REST 요청마다 고유한 OperationID를 생성하세요. 응답에 같은 값이 반복되므로 요청과 응답을 짝지을 수 있습니다.
- REST 명령이 기기에 도달하는 데는 약 15초가 걸립니다.
- 코드 12와 14는 사용되지 않습니다.
관련 문서: Callback URL not receiving data(Callback URL이 데이터를 받지 못할 때), Add or delete users in bulk(사용자 일괄 추가 또는 삭제).
도움이 필요하면 OperationID와 StatusCode를 함께 support@camsbiometrics.com으로 이메일을 보내 주세요.
Was this article helpful?