از اینجا شروع کنید
خطاها و تلاش مجدد
ساختار استاندارد خطای JSON را parse کنید و تشخیص دهید چه زمانی تلاش مجدد امن است.
ساختار خطا
خطاهای JSON API از یک شیء error در سطح بالا استفاده میکنند که شامل یک message قابلفهم برای انسان، status عددی HTTP و یک code پایدار اختیاری است. قرارداد OpenAPI برای خطاهای مورد انتظار و غیرمنتظره به همین schema ارجاع میدهد.
{
"error": {
"code": "invalid_request",
"message": "A verified From domain is required",
"status": 403
}
}خطاهای سمت کلاینت
خطاهای ورودی 400 را پیش از تلاش مجدد اصلاح کنید. پس از 401 اعتبارنامههای نامعتبر را جایگزین یا باطل کنید. 402 به اشتراک پولی نیاز دارد، 403 نشاندهنده مرز سیاست یا مجوز است، 404 یعنی منبعی در محدوده tenant پیدا نشد، 409 تعارض وضعیت یا idempotency است، 413 از محدودیت پیوست فراتر رفته و 422 خطاهای اعتبارسنجی یا توقف ارسال را پوشش میدهد.
تصمیمگیری درباره تلاش مجدد
Do not automatically retry authentication, validation, suppression, conflict, or 402 subscription_required failures. A 402 means the workspace has no active subscription; choose a plan, then send. A 423 with code sender_paused means the exact From identity is paused. A 423 with code account_paused means the workspace is paused for review: the body includes the measured bounce and complaint rates and the limits they crossed (bounce_rate vs bounce_limit, complaint_rate vs complaint_limit). Stop that stream. A 429 with code daily_limit_reached is the workspace daily ladder, not a short backoff. Wait until resets_at (midnight UTC). Retry-After is the seconds until then. hourly_limit_reached waits until the next UTC hour. gmail_recipient_limit waits until midnight UTC. The refused message was not queued. Other 429 responses (quota_exhausted) wait until that monthly, per-sender, or attachment limit resets. A caller may retry a transient 502 or 503 with bounded exponential backoff and jitter. Preserve the same Idempotency-Key and identical JSON payload when retrying one logical send.
اطلاعات لازم برای پشتیبانی
زمان درخواست، مسیر، وضعیت HTTP، شناسه منبع SendHQ و فیلدهای غیرمحرمانه خطا را ثبت کنید. هرگز کلید API، کوکی نشست، متن پیام یا فهرست گیرندگان را در گزارش پشتیبانی قرار ندهید.