시작하기 / 오류 응답
시작하기 / 오류 응답
오류 응답
오류는 HTTP 상태 코드와 함께 같은 모양의 JSON 으로 돌아옵니다. message 는 사람이 읽는 한국어 문장이라 그대로 화면에 띄워도 됩니다.
상태 코드
| 코드 | 언제 | 어떻게 |
|---|---|---|
| 400 | 입력이 잘못됐을 때. 연락처 형식, 서명자 수 불일치, 건수 부족 | message 를 읽고 고쳐 다시 보냅니다 |
| 401 | 키가 없거나 폐기됐거나 요금제가 프로가 아닐 때 | 키와 요금제를 확인합니다 |
| 403 | 읽기 전용 키로 쓰기를 했을 때, 요금제에 없는 기능을 썼을 때 | 권한이 있는 키로 바꿉니다 |
| 404 | 남의 워크스페이스 리소스이거나 없는 ID | 존재 여부를 숨기려고 403 대신 404 를 줍니다 |
| 500 | 서버 문제 | 잠시 뒤 다시 시도하고, 계속되면 문의해 주세요 |
자주 만나는 400
연락처 형식이 올바르지 않습니다: 이메일 채널인데@가 없거나, 문자 채널인데 휴대전화 형식이 아닙니다해당 채널은 아직 사용할 수 없습니다: 카카오알림톡은 아직 연동 전입니다. 이메일이나 문자를 쓰세요크레딧이 부족합니다: 대량 발송은 시작 전에 필요한 건수를 다 확인합니다대량 전송은 서명자가 1명인 서식만 지원합니다: 역할이 둘 이상인 서식은requests/with-template로 보냅니다
발송은 부분 실패를 허용하지 않습니다. 한 문서 안에서 알림이 일부 실패하면 문서는 그대로 만들어지고, 실패한 상대는 재발송으로 다시 보낼 수 있습니다. 응답의 진행 이력에 delivery_failed 로 남습니다.
더 궁금한 점이 있나요?
콘솔 사용법은 사용자 가이드를 보세요. 연동 중 막히면 hello@lillo.cx 로 요청·응답을 함께 보내 주세요.
오류 형태
json
{
"message": "연락처 형식이 올바르지 않습니다: 김하늘(haneul.partner.co)",
"error": "Bad Request",
"statusCode": 400
}