API заавар

Алдаа

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

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

Хариу402 Payment Required
{
  "error": {
    "code": "insufficient_credits",
    "message": "Not enough credits.",
    "balance": 40,
    "required": 80
  }
}

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

HTTPКодУтга
400invalid_requestХүсэлт буруу: талбар дутуу, утга буруу, эсвэл JSON биш.
401invalid_api_keyТүлхүүр байхгүй, буруу эсвэл хүчингүй.
402insufficient_creditsКредит хүрэлцэхгүй. balance, required талбартай.
402subscription_requiredТуршилт дууссан боловч ДАН-аар баталгаажаагүй, эсвэл суурь хураамж төлөгдөөгүй.
403forbiddenЭнэ үйлдлийг хийх эрхгүй.
403ip_not_allowedТүлхүүрийн IP хязгаарт ороогүй хаягаас ирсэн хүсэлт.
403sending_pausedАгуулгын шалгалтад олон мессеж татгалзагдсан, имэйл хэт олон буцсан эсвэл спам гэж тэмдэглэгдсэн, эсвэл WeSend шалгаж буй тул илгээлт түр зогссон. Дараалалд байгаа багц, сурталчилгаа хүлээгдэнэ. Баталгаажуулах код хэвээр илгээгдэнэ. [email protected] хаягаар холбогдоно уу.
403trial_recipientТуршилтын үед зөвхөн эзэмшигчийн баталгаажсан утас, имэйл рүү илгээнэ.
404not_foundИйм дугаартай зүйл энэ төсөлд алга, эсвэл хаяг буруу.
410verification_expiredБаталгаажуулалтын хугацаа дууссан.
422unsupported_numberДугаар дэмжигдсэн операторынх биш.
422content_rejectedМессеж залилан, фишинг, заналхийлэл, хувийн хэрэглээ гэх мэт үйлчилгээний нөхцөлд хориглосон агуулгатай байж болзошгүй тул илгээгдээгүй. Кредит хасагдаагүй. data.category шалтгааны төрлийг, data.clause зөрчсөн заалтын дугаарыг, data.terms тухайн заалтын холбоосыг заана.
422message_too_longSMS 4 хэсгээс урт, имэйл 256 KB-аас их, эсвэл хүсэлт 1 MB-аас их.
422invalid_codeБаталгаажуулах код буруу. attempts_remaining талбартай.
429rate_limitedХэт олон хүсэлт. Retry-After толгойг харна уу.
429recipient_rate_limitedЭнэ хүлээн авагч руу хэт олон мессеж илгээсэн.
429max_attempts_reachedБуруу код хэт олон удаа оруулсан.
502provider_failedОператор мессежийг хүлээн аваагүй. Кредит буцаагдсан. id талбартай.
500server_errorМанай талд алдаа гарсан.

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

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

Хүсэлтийн дугаар

Хариу бүр X-Request-Id толгойтой, алдааны хариу мөн error.request_id талбартай. Самбарын «API түлхүүр» хэсгийн «API хүсэлтийн түүх»-ээс сүүлийн 7 хоногийн хүсэлт, алдаа, хурдны хязгаарт орсон хүсэлтээ энэ дугаараар хайж болно. [email protected] хаягаар холбогдохдоо дугаарыг дамжуулбал бид яг тэр хүсэлтийг шууд олно.