FAXジョブの状態を確認する

自分のジョブを検索する

有効な MultiTEL API アカウントを使用してください。パスワードアカウントでは HTTP Basic の認証情報を、トークンアカウントでは Bearer トークンを送信します。アカウントの権限と IP 制限は引き続き適用されます。内部ワーカーの認証情報を使用しないでください。

curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
  --data-urlencode job_id=0123456789abcdef0123456789abcdef \
  https://api.multitel.net/v3/fax_status

job_id は必須です。send_fax が返す32文字の十六進数の識別子でなければなりません。正確にコピーしてください。リクエストは認証された所有者の範囲に限定されます。

結果を読み取る

HTTP の結果と JSON の status.code フィールドの両方を確認してください。JSON の失敗が HTTP 200 とともに返る場合があります。成功した JSON レスポンスには status と response が含まれます。例では架空のデータを使用しています。

{
  "status": {
    "code": 200,
    "msg": "Fax status"
  },
  "response": {
    "job_id": "0123456789abcdef0123456789abcdef",
    "from_number": "+12125550123",
    "to_number": "+12125550124",
    "status": "queued",
    "result": "",
    "pages_requested": 3,
    "pages_sent": 0,
    "cost": "0.07500",
    "webhook_status": "",
    "created_at": "2026-10-23 10:00:00",
    "updated_at": "2026-10-23 10:00:00"
  }
}

例はキュー内のジョブであり、配信済みの FAX や見積もりではありません。pages_requested は検出された送信元文書のページ数です。pages_sent は処理中に記録された進捗を示します。cost は十進数の文字列で、キュー内で待機中でも既に推定値が入っている場合があります。result には処理の詳細が含まれます。webhook_status には記録されたコールバックの状態が含まれます。タイムスタンプはサーバー形式の文字列で、タイムゾーンのオフセットはありません。

短い間隔でループするのではなく、間隔を徐々に長くしてポーリングしてください。処理で送信済みまたは完了の状態が報告されることはありますが、現在の監査では受信者への配信保証は確認されていません。重要な文書は、配信済みとみなしたり重複して送信したりする前に、受信者に受領を確認してください。稼働中のワーカーのライフサイクル、最終的な請求ルール、コールバックの契約は引き続き検証中です。キューへの受け付けや空でないジョブ ID が、配信を意味するとは考えないでください。

エラー

API コード 400 は job_id の欠落または形式不正、401 は認証の欠落、404 はこのアカウントでジョブが見つからなかったことを意味します。識別子だけで所有権を判断しないでください。