v3 一括復元
このAPI機能の目的は、電話番号を一括で復元することです。 POST：https://api.multitel.net/v3/bulk_restore - 認証：ユーザーのAPI認証情報によるHTTP Basic認証。 - 本文（application/json）： {
"numbers":
[
"15551230111",
"15551230112",
"15551230113"
],
"webhook_url": "https://client.example.com/restore-hook"
} - 数字のみの文字列を受け付けます。numbers_text（改行区切り）も使用できます。 - 10件以下の番号 → 同期的に処理されます。10件を超える場合 → キューに入れられ、サービスワーカーによって処理されます。 - 同期レスポンス（10件以下の番号が指定された場合のみ可能）： {
"job_uuid": "8f6c1f0e-23d2-4717-8c8e-1a518e5738f0",
"status": "completed",
"total_numbers": 3,
"success_count": 1,
"failure_count": 2,
"webhook_url": "https://client.example.com/restore-hook",
"created_at": "2025-10-28 12:31:45",
"started_at": "2025-10-28 12:31:45",
"completed_at": "2025-10-28 12:31:48",
"results": [
{
"number": "15551230111",
"status": "success",
"message": "Number restored",
"status_code": 200,
"requires_identity_update": 0
},
{
"number": "15551230112",
"status": "failed",
"message": "Error: 'restore failed, please contact support'",
"status_code": 500,
"requires_identity_update": 0
},
{
"number": "15551230113",
"status": "success",
"message": "Number restored",
"status_code": 200,
"requires_identity_update": 1,
"needs_registration": 1
}
]
} ペイロードの処理中にエラーが発生した場合（タイムアウト、DNSでドメインを解決できない場合など）、「results」配列の後にエラーが返されます： "webhook_error":"Could not resolve host: asidhaiufsd0uf.multitel.net" または、10件を超える番号が指定された場合： - キュー済み（202 Accepted）： {
"job_uuid": "c5bc4f3a-7b0a-4d5d-9f7e-d3fd87f41a00",
"status": "pending",
"total_numbers": 25,
"webhook_url": "https://client.example.com/restore-hook",
"message": "Restore job queued. Results will be POSTed to https://client.example.com/restore-hook"
} - Webhookペイロードは最終的な同期構造と同一です（番号ごとのステータスコード／メッセージを含みます）。 ステータスポーリング - GET https://api.multitel.net/v3/bulk_restore_status - 必須のjob_uuid、任意のnumber（数字のみ）。 - レスポンスは、現在の番号ごとの状態に試行回数とタイムスタンプを加えたジョブ概要を反映します。numberフィルターを指定すると、そのエントリのみが返されます。 - 例：GET …/bulk_restore_status?job_uuid=8f6c1f0e-23d2-4717-8c8e-1a518e5738f0 - フィルターあり：GET …/bulk_restore_status?job_uuid=…&number=15551230113 - GET https://api.multitel.net/v3/bulk_restore_status - 認証：他のv3呼び出しと同じHTTP Basic認証。 - クエリパラメーター： - job_uuid（必須）– POSTレスポンスから返されます。 - number（任意）– 数字のみ。結果を単一のDIDに絞り込みます。 - レスポンスはWebhookペイロードを反映し、requires_identity_update（1/0）と、該当する場合はneeds_registrationも含まれるようになりました。例： {
"job_uuid": "8f6c1f0e-23d2-4717-8c8e-1a518e5738f0",
"status": "processing",
"total_numbers": 25,
"success_count": 10,
"failure_count": 0,
"webhook_url": "https://client.example.com/restore-hook",
"created_at": "2025-10-28 12:31:45",
"started_at": "2025-10-28 12:31:45",
"completed_at": null,
"results": [
{
"number": "15551230111",
"status": "success",
"message": "Number restored",
"status_code": 200,
"attempts": 1,
"started_at": "2025-03-28 12:31:45",
"completed_at": "2025-03-28 12:31:47",
"requires_identity_update": 0
},
{
"number": "15551230112",
"status": "failed",
"message": "Error: 'restore failed, please contact support'",
"status_code": 500,
"attempts": 1,
"started_at": "2025-03-28 12:31:45",
"completed_at": "2025-03-28 12:31:46",
"requires_identity_update": 0
},
{
"number": "15551230113",
"status": "success",
"message": "Number restored",
"status_code": 200,
"attempts": 1,
"started_at": "2025-03-28 12:31:45",
"completed_at": "2025-03-28 12:31:48",
"requires_identity_update": 1,
"needs_registration": 1
}
]
} - number=15551230113を指定した場合、results配列にはそのエントリのみと、ペイロード内のfiltered_numberが含まれます。 独自の一括復元機能を作成する場合は、以下の単一番号用APIエンドポイントを使用し、復元したい各番号に対して繰り返し呼び出すことができます。 curl -u 'USERNAME:PASSWORD' \
-H 'Accept: application/json' \
https://api.multitel.net/v3/restore/447000123456