アカウントとプロジェクトへのアクセス
許可されたIPアドレスから、有効なAPIアカウントをHTTPS経由で使用してください。プロジェクトはそのアカウントに属し、削除されていない必要があります。ポーティング注文の手順で得たプロジェクトの一意のIDを使用し、データベースの数値IDや電話番号は使用しないでください。リクエストの作成時には、プロジェクトIDをURLエンコードしてください。
リクエスト
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/numbers"レスポンス
架空のレスポンス例です。
{
"status": {
"code": 200,
"msg": "Project Numbers",
"results": 1
},
"response": [
{
"id": 21,
"number": "12025550123",
"status": 0,
"status_str": "Pending",
"isocode": "US",
"updated": "2026-10-23 12:00:00",
"foc": "",
"comment": "Example customer-visible note",
"date_created": "2026-10-23 12:00:00",
"date_completed": ""
}
]
}responseはリストです。番号がない既存のプロジェクトは、APIコード200と、status.resultsが0の空リストを返します。一方、存在しないプロジェクトはAPIコード404を返します。
番号のフィールド
| フィールド | 意味 |
|---|---|
| id, number, isocode | 数値の行ID、保存された電話番号のテキスト、国コードです。行IDはプロジェクトIDではありません。 |
| status, status_str | 数値のステータスと、その既知のラベルです。 |
| foc | 保存された最終注文確約のスケジュール値です。空の場合があります。ハンドラーはこの値を文書化されたタイムゾーンやタイムスタンプ形式に変換しません。 |
| updated, date_created, date_completed | 保存された更新、作成、完了の値です。空の値を明示的に処理してください。ISO8601形式と決めつけたり、架空の例からタイムゾーンを推測したりしないでください。 |
| comment | 保存された顧客向けコメントです。実行可能なHTMLではなく、テキストとして表示してください。 |
このレスポンス構造には、スタッフ専用のinternal_commentフィールドは含まれません。別の旧式の単一番号検索が同じ構造を使うことを意味するものではありません。
並び順と監視
クエリは作成時刻の昇順で並べます。作成時刻が等しい行について、それ以外の順序は保証されません。ページ分割、増分カーソル、日付フィルターはありません。プロジェクトの照合にはリスト全体を読み取り、現在の行数を恒久的なカタログとみなさないでください。
ポーティングのステータスの解釈
| 値 | ラベル |
|---|---|
| 0 | Pending |
| 1 | In Progress |
| 2 | Completed |
| 9 | Rejected |
数値のステータスを保持し、未知の値にも対応してください。ラベルが不明な場合は保存された値にフォールバックし、新しいラベルが必ず提供されるわけではありません。保存された完了ステータスや予定日だけでは、着信ルーティングやその番号のすべてのサービスをテストしたことにはなりません。
エラーと制限
HTTPレスポンスとstatus.code/status.msgの両方を確認してください。存在しない、削除済み、またはそのアカウントが所有していないプロジェクトは、プロジェクトが見つからない旨のメッセージとAPIコード404を返します。認証と送信元IPの制限も適用されます。例では実際のリクエストを行いません。成功レスポンスは、通信事業者が移管を受け付けた、または完了したことの証明ではありません。
作用
確認済みのハンドラーは、プロジェクトと保存された番号の行を読み取るだけです。レスポンスはスナップショットであり、通信事業者からの確認や実際のサービスのテストではありません。ポーティングの開始、ルーティングの変更、アカウントへの課金は行いません。