خطاها

شکل خطا

{
  "error": {
    "code": "plan_inactive",
    "message": "Your plan is not active.",
    "request_id": "req_8f2Kq9mR"
  }
}

همیشه request_id را لاگ کنید. وقتی با پشتیبانی تماس می‌گیرید، همین مقدار است که به ما امکان می‌دهد درخواست دقیق شما را پیدا کنیم.

کدها

400 و 422 دو خطای متفاوت‌اند

400 یعنی درخواست اصلاً به مرحله اعتبارسنجی نرسیده است: یک پارامتر الزامی وجود ندارد، یک timestamp قابل تجزیه نیست، یا limit خارج از بازه است. 422 یعنی درخواست ساختار درستی داشته اما محتوای آن رد شده است، مثلاً قانون کامنتی که نه پاسخ دارد و نه دایرکت.

{
  "error": {
    "code": "bad_request",
    "message": "`from` must be earlier than `to`.",
    "request_id": "req_8f2Kq9mR",
    "details": { "from": "2026-09-30T00:00:00Z", "to": "2026-09-01T00:00:00Z" }
  }
}

یک کد برای همه کلیدهای نامعتبر

کلید جاافتاده، اشتباه، باطل‌شده یا منقضی، همه با 401 invalid_key پاسخ داده می‌شوند. اگر کلید منقضی را از کلید ناشناخته جدا کنیم، به هر کسی که کلید لورفته‌ای در دست دارد تأیید کرده‌ایم که آن کلید زمانی واقعی بوده است. تاریخ انقضای کلید شما در توافق‌نامه‌ای است که فروش برایتان فرستاده؛ پیش از آن تاریخ کلید جدید درخواست کنید.

404، نه 403، برای منابع دیگران

اگر منبعی را درخواست کنید که وجود دارد اما متعلق به شریک دیگری است، 404 دریافت می‌کنید، نه 403. پاسخ 403 وجود آن شناسه را تأیید می‌کرد، و این اطلاعاتی است که نباید بتوانید آن را کاوش کنید.

details

برخی خطاها، جایی که یک عدد به شما در اقدام کمک می‌کند، یک شیء details همراه دارند:

{
  "error": {
    "code": "capacity_exhausted",
    "message": "You have reached the maximum number of channels your plan allows.",
    "request_id": "req_8f2Kq9mR",
    "details": { "occupied": 10, "requested": 1, "capacity": 10 }
  }
}

این شیء هرگز در 401 یا 404 نمی‌آید؛ آنجا جزئیات بیشتر چیزی را تأیید می‌کرد که نباید بفهمید.

کدام خطاها ارزش تلاش دوباره دارند