エラーとレート制限

API エラーには code と message が含まれます。項目の検証エラーには errors オブジェクトも含まれます。アプリの分岐にはメッセージ文ではなく code を使ってください。

{
  "code": "validation_error",
  "message": "The given data was invalid.",
  "errors": {"to": ["The to field must be a valid email address."]}
}

HTTP	コード	対応
401	invalid_api_key	有効な正しいキーか確認。
402	payment_required	ワークスペースの請求画面で支払いを完了。
403	access_denied	ワークスペースの状態、送信プラン、対象機能を確認。
404	not_found	メッセージ ID とプロジェクトのキーを確認。
409	idempotency_conflict	再試行には元の内容を使用。新しいメールにのみ新しいキーを使用。
413	request_too_large	JSON リクエスト本文を 64 KiB 以下に削減。
422	validation_error	項目、必須変数、公開済み言語、送信設定を確認。
429	email_capacity_exceeded	請求画面で追加メールの自動購入を有効化するかプランを変更。
429	rate_limited	Retry-After の時間を待って再試行。
500、502、503、504	server_error	同じキーと内容で、時間を空けて再試行。

送信と状態取得の合計で、プロジェクトごとに毎分 120 リクエストまでです。プロジェクト内のすべての API キーで共有します。IP アドレスごとに毎分 600 リクエストの上限もあります。rate_limited には待機秒数を示す Retry-After ヘッダーが含まれます。email_capacity_exceeded は請求画面での対応が必要で、待機しても送信枠は増えません。

SDK では HTTP ステータス、コード、項目エラー、再試行までの待機時間を確認できます。ステータス 0 は SDK のエラーです。connection_error はリクエスト未完了、invalid_response はレスポンスを読み取れなかったことを示します。受付済みの可能性があるため、元のキーと内容で再試行してください。