센드온 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	서버에서 예상치 못한 오류가 발생했습니다.	문제가 지속되면 센드온 지원팀에 문의하세요.

에러 코드	메시지	설명	해결 방법
429	Too Many Requests	요청 속도가 허용 한도를 초과했습니다.	요청 빈도를 줄이고, 필요한 경우 한도 상향을 요청하세요.

에러 코드	메시지	설명	해결 방법
404	Not Found	요청한 리소스를 찾을 수 없습니다.	엔드포인트 URL과 리소스 ID를 다시 확인하세요.
408	Request Timeout	요청 시간이 초과되었습니다.	네트워크 상태를 점검하고, 재시도 로직을 추가하세요.

센드온 API 및 SDK는 안정적인 서비스를 위해 정기적으로 업데이트되며, 에러 처리 방안을 지속적으로 개선하고 있습니다.