API заавар

Алдаа

Алдаа бүр HTTP статус код болон машинд уншигдах кодтой ирнэ.

Амжилтгүй хүсэлтийн хариу үргэлж error объекттой. Кодоор нь шалгаж, message-ийг зөвхөн бүртгэл, дибаг хийхэд ашиглана: мессежийн үг өөрчлөгдөж болно.

Хариу402 Payment Required

{
  "error": {
    "code": "insufficient_credits",
    "message": "Not enough credits.",
    "balance": 40,
    "required": 70
  }
}

Алдааны кодууд

HTTP	Код	Утга
400	invalid_request	Хүсэлт буруу: талбар дутуу, утга буруу, эсвэл JSON биш.
401	invalid_api_key	Түлхүүр байхгүй, буруу эсвэл хүчингүй.
402	insufficient_credits	Кредит хүрэлцэхгүй. `balance`, `required` талбартай.
402	subscription_required	Туршилт дууссан эсвэл суурь хураамж төлөгдөөгүй.
403	forbidden	Энэ үйлдлийг хийх эрхгүй.
403	trial_recipient	Туршилтын үед зөвхөн эзэмшигчийн баталгаажсан утас, имэйл рүү илгээнэ.
404	not_found	Ийм дугаартай зүйл энэ төсөлд алга, эсвэл хаяг буруу.
410	verification_expired	Баталгаажуулалтын хугацаа дууссан.
422	unsupported_number	Дугаар дэмжигдсэн операторынх биш.
422	message_too_long	SMS 5 хэсгээс урт, имэйл 256 KB-аас их, эсвэл хүсэлт 1 MB-аас их.
422	invalid_code	Баталгаажуулах код буруу. `attempts_remaining` талбартай.
429	rate_limited	Хэт олон хүсэлт. `Retry-After` толгойг харна уу.
429	recipient_rate_limited	Энэ хүлээн авагч руу хэт олон мессеж илгээсэн.
429	max_attempts_reached	Буруу код хэт олон удаа оруулсан.
502	provider_failed	Оператор мессежийг хүлээн аваагүй. Кредит буцаагдсан. `id` талбартай.
500	server_error	Манай талд алдаа гарсан.

Хэрхэн хандах вэ

4xx алдааг ижил хүсэлтээр дахин бүү оролд. Хүсэлтээ засах эсвэл хэрэглэгчид мэдэгдэнэ. Үл хамаарах нь 429: Retry-After секунд хүлээгээд дахин илгээнэ.
502 provider_failed-ийг дахин оролдож болно: кредит буцсан. Операторын түр саатал байж магадгүй.
500 server_error эсвэл сүлжээний тасалдлын үед мессеж илгээгдсэн эсэх тодорхойгүй. Давхар илгээхээс сэргийлж Idempotency-Key толгойтой дахин оролдоно.