HTTPSと、承認済みのAPI認証情報を用いたHTTP Basic認証を使用してください。認証情報はアプリケーションサーバー上で保管してください。これらのホステッドPBXエンドポイントでは、/hpbx/ を api.multitel.net で使用します。/v3 は挿入しないでください。HTTPの結果と、JSONレスポンス内のアプリケーションレベルの処理結果ステータスの両方を確認してください。
日付範囲を限定してデータを要求する
curl --request POST --user "USERNAME:PASSWORD" \
--data-urlencode "date_from=2026-10-01" \
--data-urlencode "date_to=2026-10-02" \
--data-urlencode "disposition=ANSWERED" \
"https://api.multitel.net/hpbx/cdrs/YOUR_BILLING_CODE?start=0&length=50"請求コードと日付を置き換えてください。日付フィルターには指定した日が含まれます。このエンドポイントでは、ボディフィルターはフォームエンコードされ、ページングはクエリ文字列に含まれます。
フィルターとレスポンス
| パラメーター | 意味 |
|---|---|
| date_from / date_to | 開始日/終了日はYYYY-MM-DD形式で指定します。 |
| wherelanded | 必要に応じた宛先フィルター。 |
| disposition | 通話結果フィルター (例: ANSWERED)。 |
| callerid | 発信番号フィルター。 |
| timezone | 使用する場合のサポートされるタイムゾーン識別子。IANA名を受け付けると想定しないでください。 |
| start / length | 返されるページを制御するクエリパラメータ。 |
通話記録には、開始時刻、発信者情報、発信元、最初の宛先、課金対象秒数、処理結果(ディスポジション)、および通話識別子が含まれます。このエンドポイントでは、返された結果構造を使用してください。ポータルAPIのページネーションとは異なる場合があります。HTTPリクエストが成功しても、結果に該当する通話が含まれていることの証明にはなりません。
ポータルREST連携には、現在の通話履歴リファレンスを使用してください。これには応答スキーマとアカウント権限が含まれます。