Support Hub/API & Integrations/API 상태 코드: 각 오류의 의미와 해결 방법
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"}으로 응답해야 합니다.

코드상태의미조치
0Success작업이 완료되었습니다.필요 없음.
1Invalid Request DataJSON 본문의 형식이 잘못되었거나 값이 올바르지 않습니다.UTF-8 raw JSON을 Content-Type: application/json 헤더와 함께 보내세요. 값을 확인하세요.
2Invalid Service Tag IDstgid 쿼리 매개변수와 일치하는 등록된 기기가 없습니다.API Monitor 계정에서 Service Tag ID를 다시 복사하세요.
3Invalid Request요청이 해당 작업의 형식을 따르지 않습니다.해당 작업의 샘플 요청과 비교하세요.
4Invalid EncryptionAES-256 페이로드를 복호화할 수 없었습니다.암호화 키와 Base64 인코딩을 확인하세요.
5Device Offline대상 기기가 현재 Cams에 연결되어 있지 않습니다.Device Status 페이지를 확인하세요. 명령은 대기열에 저장되었다가 기기가 다시 연결되면 전달됩니다.
6Operation Timeout기기가 제때 명령에 응답하지 않았습니다.기기가 온라인인지 확인한 후 다시 시도하세요.
7Invalid Auth TokenAuthToken이 기기에 설정된 토큰과 일치하지 않습니다.API Monitor의 32자리 토큰을 사용하세요.
8User Already Exists이미 기기에 있는 UserID로 추가를 시도했습니다.대신 사용자를 업데이트하거나 먼저 사용자를 삭제하세요.
9User Not Found해당 UserID가 기기에 없습니다.UserID를 확인하세요. 필요하면 먼저 사용자를 추가하세요.
10Template Error생체 템플릿이 손상되었거나 지원되지 않는 형식입니다.템플릿의 Base64 데이터, Size, Index를 확인하세요.
11Device Memory Full기기가 사용자 또는 템플릿의 한도에 도달했습니다.더 이상 필요 없는 사용자나 템플릿을 삭제하세요.
13Invalid Security Key보안 키가 API Monitor의 키와 일치하지 않습니다.양쪽에서 같은 키를 사용하세요.
15Feature Not Supported이 기기 모델 또는 연결 모드는 해당 작업을 지원하지 않습니다.연결 모드를 확인하세요. DB Pull 및 File Processing 모드는 출퇴근 push만 지원하며 RESTful 명령은 지원하지 않습니다.
999Unknown 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?