센드온 API는 모든 요청에 대해 HTTP 상태 코드 200으로 응답합니다.
실제 요청의 성공/실패 여부는 응답 본문 내의code 필드로 판단해주세요.
중요: HTTP 상태 코드(항상 200)와 응답 본문의 code는 서로 다른 의미를 가집니다.
응답 구조
모든 API는 다음과 같은 일관된 구조로 응답합니다.
성공 응답
{
"code": 200,
"message": "요청이 성공했습니다",
"data": {
// 실제 응답 데이터
}
}에러 응답
에러에 대한 상세 정보는 message 필드를 참고하시면 됩니다.
{
"code": 401,
"message": "허가되지 않은 IP에서의 접근입니다. Whitelist IP 등록 후 이용해주세요."
}주요 에러 코드
인증 관련
| 에러 코드 | 메시지 | 설명 | 해결 방법 |
|---|---|---|---|
| 401 | Unauthorized | API 키가 잘못되었거나 권한이 없습니다. | 올바른 API 키를 사용하고, 권한이 있는지 확인하세요. |
| 403 | Forbidden | API 호출에 필요한 권한이 부족합니다. | 계정 설정에서 권한을 확인하거나 관리자에게 문의하세요. |
요청 데이터 관련
| 에러 코드 | 메시지 | 설명 | 해결 방법 |
|---|---|---|---|
| 400 | Bad Request | 요청 데이터가 잘못되었거나 누락된 필드가 있습니다. | 요청 데이터를 검증하고 필수 필드가 모두 포함되었는지 확인하세요. |
| 422 | Unprocessable Entity | 요청 데이터 형식이 올바르지 않습니다. | 요청 데이터의 형식과 값을 다시 확인하세요. |
서버 및 네트워크 관련
| 에러 코드 | 메시지 | 설명 | 해결 방법 |
|---|---|---|---|
| 500 | Internal Server Error | 서버에서 예상치 못한 오류가 발생했습니다. | 문제가 지속되면 센드온 지원팀에 문의하세요. |
Rate Limit 관련
| 에러 코드 | 메시지 | 설명 | 해결 방법 |
|---|---|---|---|
| 429 | Too Many Requests | 요청 속도가 허용 한도를 초과했습니다. | 요청 빈도를 줄이고, 필요한 경우 한도 상향을 요청하세요. |
기타
| 에러 코드 | 메시지 | 설명 | 해결 방법 |
|---|---|---|---|
| 404 | Not Found | 요청한 리소스를 찾을 수 없습니다. | 엔드포인트 URL과 리소스 ID를 다시 확인하세요. |
| 408 | Request Timeout | 요청 시간이 초과되었습니다. | 네트워크 상태를 점검하고, 재시도 로직을 추가하세요. |
참고 사항
- 모든 에러는 HTTP 상태 코드와 함께 상세한 메시지가 반환됩니다. 이를 기반으로 문제를 분석하세요.
- 문제가 지속되거나 명확하지 않은 경우, 지원팀에 문의하세요.
센드온 API 및 SDK는 안정적인 서비스를 위해 정기적으로 업데이트되며, 에러 처리 방안을 지속적으로 개선하고 있습니다.