가이드
에러 코드
모든 오류는 일관된 봉투(envelope) 형식으로 반환됩니다. HTTP 상태 코드와 error.code를 함께 확인하세요.
오류 봉투 형식
성공 응답은 { success: true, data }, 오류 응답은 { success: false, error } 형태입니다.error는 code, message, details를 포함합니다.
오류 응답
{
"success": false,
"error": {
"code": "AGENT_003",
"message": "요청을 처리할 수 없습니다.",
"details": null
}
}에이전트 API 에러 코드
| 코드 | HTTP | 의미 |
|---|---|---|
| AGENT_001 | 401 | 유효하지 않은 API 키 |
| AGENT_002 | 401 | 폐기되었거나 만료된 API 키 |
| AGENT_003 | 403 | 해당 작업에 필요한 스코프 부족 |
| AGENT_004 | 429 | 레이트 리밋 초과 (분당 60회) |
| COMMON_002 | 404 | 리소스를 찾을 수 없음 (타 계량소 접근은 404와 구분되지 않음) |