アカウントとプロジェクトへのアクセス
許可された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/events"レスポンス
架空のレスポンス例です。
{
"status": {
"code": 200,
"msg": "Project Events",
"results": 1
},
"response": [
{
"id": 31,
"subject": "Example project update",
"event": "{\"type\":\"comment\",\"value\":\"Example update\",\"source\":\"Example source\"}",
"type": "comment",
"value": "Example update",
"source": "Example source",
"date_created": "2026-10-23 12:00:00"
}
]
}イベントがない既存のプロジェクトでは、APIコード200と空のリストが返され、status.resultsは0になります。結果は作成日時の降順で要求されます。同じ日時の結果に対する追加の並び順、ページネーション、カーソル、日付フィルターはありません。
イベントペイロードを慎重に読み取る
idはイベント行の数値ID、subjectは保存されている件名、date_createdは保存されている日時の値です。このエンドポイントは、生のevent文字列を保持し、その中のtype、valueおよびsourceのデコードも試みます。ペイロードがJSONオブジェクトでない場合や、プロパティが欠けている場合、対応する解析済みフィールドは空文字列になります。
ペイロードは固定の列挙型ではなく、プレーンテキストのスキーマであることも保証されません。ソースのテキストを検証済みの身元情報として扱ったり、イベントの内容をHTMLとして描画したりしないでください。生のイベントは権限のあるサーバー側のワークフロー内で扱い、権限のあるユーザーに適切なテキストだけを表示してください。このエンドポイントには、スタッフと顧客それぞれに対するイベントの表示可否を制御する専用フィルターや、内容を伏せる機能はありません。
履歴は配信を保証するものではありません
これは保存済みのプロジェクト履歴です。Webhookストリーム、不変の同期カーソル、データベースのすべての変更を網羅する記録ではありません。たとえば、レビュー済みの番号追加ハンドラーを使って番号を追加しても、その操作自体ではイベントは作成されません。イベントを読み取るだけでなく、番号リストとステータス別の件数も照合してください。
エラーと制限
HTTPレスポンスとstatus.code/status.msgの両方を確認してください。プロジェクトが存在しない場合、削除されている場合、またはそのアカウントに属していない場合は、プロジェクトが見つからないことを示すメッセージとともにAPIコード404が返されます。認証と送信元IPアドレスの制限も適用されます。これらの例は実際のリクエストを送信するものではありません。また、成功レスポンスが返っても、通信事業者が番号移行を受け付けたことや完了したことの証明にはなりません。
処理による影響
レビュー済みのハンドラーは保存済みのイベントを読み取るものであり、プロジェクトの変更、番号移行の開始、アカウントからの料金引き落としは行いません。イベント書き込み処理の可視性と、認証済みアカウントを使用したテストは、未完了の契約仕様レビューの対象として残っています。