오류 코드 — WhatsApp 데이터 API
모든 오류 응답은 HTTP 상태 코드 + 오류 메시지 + 숫자 코드 + 타임스탬프라는 동일한 형식을 따릅니다.
봉투 모양 (관찰됨)
프록시는 오류 모드에 따라 다음 두 가지 형태 중 하나를 반환합니다.
간략 오류(인증/버스트 제한/유효성 검사):
{ "error": "Requests must be at least 0.5 seconds apart" }자세한 오류 메시지 (/number/no_picture/{n}, /number-simple/{n}에 대한 조회 실패) — 본문이 여전히 추가 필드가 있는 WhatsAppEntry로 구문 분석됩니다.
{
"number": "13105551234",
"isWAContact": true,
"error": "Whatsapp number doesn't exist",
"exists": false,
"reason": "not_found",
"status": 404,
...
}200 응답을 받는 경우에도 항상 오류 필드를 확인하세요(예: /number_cache는 오류 메시지와 함께 200 응답을 반환할 수 있습니다).
일반적인 HTTP 상태 코드
| HTTP | 의미 | 행동 |
|---|---|---|
| 400 | 잘못된 전화번호입니다. ^[0-9]+$ (숫자만, + 기호 없음)와 일치해야 합니다. | 전송하기 전에 숫자 이외의 문자를 제거합니다. libphonenumber 라이브러리를 사용하여 로컬에서 유효성을 검사합니다. |
| 401 | x-rapidapi-key 헤더가 누락되었거나 유효하지 않습니다. | 헤더에 x-rapidapi-key 및 x-rapidapi-host: wp-data.p.rapidapi.com을 추가하세요. |
| 403 | 활성 요금제가 필요하거나, 할당량이 소진되었거나, 엔드포인트가 사용 중인 요금제에 포함되지 않았습니다. | RapidAPI 구독을 확인하세요. 요금제를 업그레이드하거나 충전하세요. |
| 404 | 엔드포인트 또는 리소스를 찾을 수 없습니다. | URL 경로를 확인하세요. /number/{number}의 경우, 알 수 없는 번호에 대한 WhatsAppEntry는 여전히 isWAContact: false 값을 반환합니다. 상태가 아닌 본문을 확인하세요. |
| 429 | 버스트 제한 — 요청 간격이 너무 짧습니다. 본문: {"error":"Requests must be at least 0.5 seconds apart"}. | 요청 간 최소 500ms의 대기 시간(초당 2회 요청). MEGA: 250ms(초당 4회 요청). 플랜의 요청 간격을 확인하려면 /api-key-stats → roleInfo.minIntervalSeconds를 참조하세요. |
| 500 | 예기치 않은 서버 측 오류가 발생했습니다. | 지수 백오프를 사용하여 재시도하십시오. 문제가 지속되면 보고해 주십시오. |
| 502 / 503 | 상위 WhatsApp 디렉터리를 사용할 수 없거나 상위 서비스에서 속도 제한이 걸렸습니다. | 백오프를 적용하여 재시도하십시오. /api-status를 확인하십시오. |
| 504 | 상위 서버 조회 시간이 초과되었습니다. | 한 번 더 시도해 보세요. 더 빠른 응답을 원하시면 /number/no_picture/{number}을 입력해 보세요. |
재시도 전략
- 재시도: 429(Retry-After 포함), 500, 502, 503, 504.
- 400, 401, 403, 404 오류는 다시 시도하지 마십시오.
- 백오프: 지터가 있는 지수 함수 방식. 재시도 횟수 제한: 5회. 재시도 후(Retry-After) 옵션을 항상 준수합니다.
예제 429 본문
HTTP/1.1 429 Too Many Requests
content-type: application/json
{ "error": "Requests must be at least 0.5 seconds apart" }관련된
사용자 리뷰
만족한 고객들의 실제 리뷰
4.5/5 (173 리뷰)