เริ่มต้นที่นี่

ข้อผิดพลาดและการลองใหม่

อ่านโครงสร้างข้อผิดพลาด JSON มาตรฐานและตัดสินใจว่าเมื่อใดลองใหม่ได้อย่างปลอดภัย

โครงสร้างข้อผิดพลาด

ความล้มเหลวของ 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 คือไม่พบทรัพยากรภายในขอบเขตของผู้เช่า 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.

ข้อมูลสำหรับซัพพอร์ต

บันทึกเวลาที่ส่งคำขอ route สถานะ HTTP ID ทรัพยากรของ SendHQ และฟิลด์ข้อผิดพลาดที่ไม่เป็นความลับ ห้ามใส่ API key คุกกี้เซสชัน เนื้อหาข้อความ หรือรายชื่อผู้รับในรายงานถึงซัพพอร์ต