通話管理APIドキュメント
これらのエンドポイントを使用すると、 不在着信, 着信応答、 そして 発信通話 SMSMobileAPI モバイル アプリからダッシュボード + API に同期されます。
重要:モバイルアプリがバックグラウンドで動作している場合、携帯電話のシステムにより同期に遅延(最大10分程度)が生じることがあります。必要に応じて、いつでもアプリを開いて手動で同期できます。
ヘルプが必要ですか? api@smsmobileapi.com
クイックスタート
ベースURL
得る https://api.smsmobileapi.com
以下のすべてのエンドポイントは次のように文書化されています。 得る リクエスト。置き換え あなたのAPIキー 実際のキーを使用します(公開しないでください)。
例
https://api.smsmobileapi.com/call/missed/list/?apikey=YOUR_API_KEY を取得します。
GET https://api.smsmobileapi.com/call/incoming/list/?apikey=YOUR_API_KEY&limit=50&offset=0&sort_by=call_date_ms&sort_dir=desc
GET https://api.smsmobileapi.com/call/outgoing/list/?apikey=YOUR_API_KEY&q=1555&date_from_ms=1700000000000&date_to_ms=1700864000000
認証
通話管理エンドポイントは、 アピキー クエリパラメータ。
サブスクリプションの検証: 受信/送信エンドポイントはAPIキーを検証し、サブスクリプションの有効性を確認します(日付制限 >= CURDATE())。期限が切れた場合は、 api_expired.
共通の概念
ページネーション
使用 制限 そして オフセット 結果をページ区切りします。
タイムスタンプ
- 通話日(ミリ秒) UNIXタイムスタンプです ミリ秒.
- 呼び出し日時utc UTC 日時文字列 (データベース フィールド) として保存されます。
- 不在着信の場合、APIはフォーマットされた 日付 文字列(ミリ秒の値から派生)。
検索
- 不在着信: 検索 番号または名前と一致します。
- 着信/発信: q マッチ 電話番号 または キャッシュ名.
ソート(受信/送信のみ)
ソートは以下によって制御されます 並べ替え + ソートディレクトリ (ホワイトリストに登録されたフィールドのみ)。不在着信は常に最新のものから順に並べられます。
このドキュメントのすべての応答例は 匿名化下記に表示されているAPIキー、電話番号、連絡先名はサンプル値です。
エラー
| HTTP | エラー例 | 意味 |
|---|---|---|
| 400 | {"成功":false,"エラー":"apikeyがありません"} | 欠落または空 アピキー. |
| 403 | {"成功":false,"エラー":"無効なAPIキー"} | API キーが見つからない / 認識されません。 |
| 403 | {"成功":false,"エラー":"api_expired"} | サブスクリプションの有効期限が切れています(日付制限 (今日以前です)。 |
| 500 | {"成功":false,"エラー":"server_error","詳細":"..."} | サーバー エラー (データベース、SQL、例外)。 |
注: 不在着信エンドポイントは次のようなメッセージも返すことができます。 apikeyがありません または状況に応じて SQL 準備エラーが発生します。
不在着信 – リスト
モバイル デバイスから同期された不在着信を取得します。
終点
得る https://api.smsmobileapi.com/call/missed/list/
クエリパラメータ
| パラメータ | タイプ | 説明 |
|---|---|---|
| アピキー | 弦 | 必須 携帯電話にリンクされた API キー。 |
| オフセット | 整数 | オプション ページ区切りオフセット(デフォルト: 0). |
| 制限 | 整数 | オプション 最大行数(デフォルト: 100、最大: 500). |
| 検索 | 弦 | オプション 番号または名前 (SQL LIKE) で検索します。 |
| 開始日 | 年-月-日 | オプション この日 (00:00:00) からフィルタリングします。 |
| 日付終了 | 年-月-日 | オプション この日(23:59:59)までフィルタリングします。 |
リクエストの例
GET https://api.smsmobileapi.com/call/missed/list/?apikey=YOUR_API_KEY&offset=0&limit=100
JSONレスポンスの例
{ "success": true, "offset": 0, "limit": 100, "count": 3, "data": [ { "number": "+15551230001", "name": "", "date": "2026-03-20 16:12:28" }, { "number": "+15551230002", "name": "Alex Carter", "date": "2026-03-20 16:12:00" }, { "number": "+447700900123", "name": "Taylor Reed", "date": "2026-03-20 15:48:41" } ] }
回答の説明
| 分野 | 説明 |
|---|---|
| 成功 | 真実 これは、リクエストが正常に処理されたことを意味します。 |
| オフセット | APIによって返されるページネーションオフセット。 |
| 制限 | リクエストにページネーション制限が適用されました。 |
| カウント | 返される行数 データ. |
| データ | 不在着信のエントリを含む配列。 |
| データ[].数値 | 発信者の電話番号。 |
| データ[].名前 | キャッシュされた連絡先名。連絡先名が利用できない場合は空欄になります。 |
| データ[].日付 | フォーマットされた通話日時。 |
上記の例は匿名化されています。実際の回答には、異なる電話番号や連絡先ラベルが含まれる場合があります。
着信 – リスト
モバイル デバイスから同期された着信応答を取得します。
終点
得る https://api.smsmobileapi.com/call/incoming/list/
クエリパラメータ
| パラメータ | タイプ | 説明 |
|---|---|---|
| アピキー | 弦 | 必須 API キー (サブスクリプションに対して検証済み)。 |
| 制限 | 整数 | オプション ページあたりの行数(デフォルト: 50、最大: 200). |
| オフセット | 整数 | オプション ページ区切りオフセット(デフォルト: 0). |
| 並べ替え | 弦 | オプション 許可された: 通話日(ミリ秒) 呼び出し日時utc 期間_秒 電話番号 作成日時 キャッシュ名 地理位置情報 |
| ソートディレクトリ | 昇順|降順 | オプション デフォルト: 説明. |
| 日付からミリ秒 | 整数(ミリ秒) | オプション フィルター call_date_ms >= date_from_ms. |
| 日付からミリ秒 | 整数(ミリ秒) | オプション フィルター call_date_ms <= date_to_ms. |
| q | 弦 | オプション 検索 電話番号 または キャッシュ名 (のように)。 |
リクエストの例
GET https://api.smsmobileapi.com/call/incoming/list/?apikey=YOUR_API_KEY&limit=50&offset=0&sort_by=call_date_ms&sort_dir=desc
JSONレスポンスの例
{ "success": true, "apikey": "YOUR_API_KEY_HASH", "limit": 50, "offset": 0, "sort_by": "call_date_ms", "sort_dir": "desc", "filters": { "date_from_ms": null, "date_to_ms": null, "q": null }, "count": 3, "rows": [ { "phone_number": "+15551230010", "cached_name": "Jordan Blake", "call_date_ms": 1774027779390, "call_datetime_utc": "2026-03-20 17:29:39", "duration_sec": 23, "geo_location": "Canada", "created_at": "2026-03-20 17:46:45" }, { "phone_number": "+15551230011", "cached_name": "Morgan Lee", "call_date_ms": 1774018268663, "call_datetime_utc": "2026-03-20 14:51:08", "duration_sec": 50, "geo_location": "Canada", "created_at": "2026-03-20 14:58:37" }, { "phone_number": "+447700900124", "cached_name": "Sam Parker", "call_date_ms": 1774011205123, "call_datetime_utc": "2026-03-20 12:53:25", "duration_sec": 92, "geo_location": "Canada", "created_at": "2026-03-20 12:59:01" } ] }
回答の説明
| 分野 | 説明 |
|---|---|
| 成功 | 真実 これは、リクエストが正常に処理されたことを意味します。 |
| アピキー | APIキーの値がそのまま出力されました。ドキュメントの例では、この値は常にマスクする必要があります。 |
| 制限 | 1ページあたりに要求される行数。 |
| オフセット | APIによって返されるページネーションオフセット。 |
| 並べ替え | APIによって適用されるソートフィールド。 |
| ソートディレクトリ | APIによって適用されるソート方向。 |
| フィルター | リクエストに使用されたアクティブなフィルターを含むオブジェクト。 |
| カウント | 返される行数 行. |
| 行 | 着信応答履歴を含む配列。 |
| rows[].電話番号 | 通話に関連付けられた電話番号。 |
| 行[].キャッシュ名 | キャッシュされた連絡先名。利用可能なデータによっては、nullまたは空になる場合があります。 |
| 行[].call_date_ms | 呼び出しタイムスタンプ(ミリ秒単位)。 |
| 行[].call_datetime_utc | 通話が行われたUTCの日時。 |
| 行[].duration_sec | 通話時間(秒)。 |
| 行[].geo_location | 利用可能な場合は、その番号に関連付けられた地理的ラベル。 |
| 行[].create_at | サーバー上で該当行が挿入された日時。 |
API はあなたの アピキー レスポンスでは、必ずマスクしてください。公開文書、スクリーンショット、および例では、必ずマスクしてください。
発信通話 – リスト
モバイル デバイスから同期された発信通話を取得します。
終点
得る https://api.smsmobileapi.com/call/outgoing/list/
クエリパラメータ
着信通話と同じパラメータと動作。
| パラメータ | タイプ | 説明 |
|---|---|---|
| アピキー | 弦 | 必須 API キー (サブスクリプションに対して検証済み)。 |
| 制限 | 整数 | オプション ページあたりの行数(デフォルト: 50、最大: 200). |
| オフセット | 整数 | オプション ページ区切りオフセット(デフォルト: 0). |
| 並べ替え | 弦 | オプション 許可された: 通話日(ミリ秒) 呼び出し日時utc 期間_秒 電話番号 作成日時 キャッシュ名 地理位置情報 |
| ソートディレクトリ | 昇順|降順 | オプション デフォルト: 説明. |
| 日付からミリ秒 | 整数(ミリ秒) | オプション フィルター call_date_ms >= date_from_ms. |
| 日付からミリ秒 | 整数(ミリ秒) | オプション フィルター call_date_ms <= date_to_ms. |
| q | 弦 | オプション 検索 電話番号 または キャッシュ名 (のように)。 |
リクエストの例
GET https://api.smsmobileapi.com/call/outgoing/list/?apikey=YOUR_API_KEY&limit=50&offset=0&sort_by=call_date_ms&sort_dir=desc
JSONレスポンスの例
{ "success": true, "apikey": "YOUR_API_KEY_HASH", "limit": 50, "offset": 0, "sort_by": "call_date_ms", "sort_dir": "desc", "filters": { "date_from_ms": null, "date_to_ms": null, "q": null }, "count": 3, "rows": [ { "phone_number": "+15551230020", "cached_name": "Casey Morgan", "call_date_ms": 1774025965645, "call_datetime_utc": "2026-03-20 16:59:25", "duration_sec": 15, "geo_location": "Canada", "created_at": "2026-03-20 17:17:58" }, { "phone_number": "+15551230021", "cached_name": "Taylor Brooks", "call_date_ms": 1774023172638, "call_datetime_utc": "2026-03-20 16:12:52", "duration_sec": 556, "geo_location": "Canada", "created_at": "2026-03-20 16:28:38" }, { "phone_number": "+33198765432", "cached_name": "Jamie Carter", "call_date_ms": 1774019040000, "call_datetime_utc": "2026-03-20 15:04:00", "duration_sec": 61, "geo_location": "Canada", "created_at": "2026-03-20 15:09:11" } ] }
回答の説明
| 分野 | 説明 |
|---|---|
| 成功 | 真実 これは、リクエストが正常に処理されたことを意味します。 |
| アピキー | APIキーの値がそのまま出力されました。ドキュメントの例では、この値は常にマスクする必要があります。 |
| 制限 | 1ページあたりに要求される行数。 |
| オフセット | APIによって返されるページネーションオフセット。 |
| 並べ替え | APIによって適用されるソートフィールド。 |
| ソートディレクトリ | APIによって適用されるソート方向。 |
| フィルター | リクエストに使用されたアクティブなフィルターを含むオブジェクト。 |
| カウント | 返される行数 行. |
| 行 | 発信通話のエントリを含む配列。 |
| rows[].電話番号 | 通話に関連付けられた電話番号。 |
| 行[].キャッシュ名 | キャッシュされた連絡先名。利用可能なデータによっては、nullまたは空になる場合があります。 |
| 行[].call_date_ms | 呼び出しタイムスタンプ(ミリ秒単位)。 |
| 行[].call_datetime_utc | 通話が行われたUTCの日時。 |
| 行[].duration_sec | 通話時間(秒)。 |
| 行[].geo_location | 利用可能な場合は、その番号に関連付けられた地理的ラベル。 |
| 行[].create_at | サーバー上で該当行が挿入された日時。 |
上記の例の値は匿名化されています。これらの値を実際のデータに置き換えるのは、社内ツールなどのプライベートな環境でのみ行い、公開文書には絶対に使用しないでください。
不在着信フィールド
| 分野 | タイプ | 説明 |
|---|---|---|
| 成功 | ブール | リクエストのステータス。 |
| オフセット | 整数 | ページ区切りオフセットが返されます。 |
| 制限 | 整数 | ページ区切りの制限が返されました。 |
| カウント | 整数 | 返される行数 データ. |
| データ | 配列 | 不在着信のリスト。 |
| データ[].数値 | 弦 | 発信者の電話番号。 |
| データ[].名前 | 弦 | キャッシュされた連絡先名(空の場合もあります)。 |
| データ[].日付 | 弦 | ミリ秒のタイムスタンプから派生したフォーマットされた日時文字列。 |
受信/送信フィールド
| 分野 | タイプ | 説明 |
|---|---|---|
| 成功 | ブール | リクエストのステータス。 |
| アピキー | 弦 | API(あなたのキー)によって返されます。公開ドキュメントでは、必ずマスクしてください。 |
| 制限 | 整数 | 返されるページあたりの行数。 |
| オフセット | 整数 | ページ区切りオフセットが返されます。 |
| 並べ替え | 弦 | 並べ替えフィールドを適用しました。 |
| ソートディレクトリ | 弦 | 並べ替えの方向を適用しました。 |
| フィルター | 物体 | エコーフィルター(日付からミリ秒, 日付からミリ秒, q). |
| カウント | 整数 | 返される行数 行. |
| 行 | 配列 | 通話のリスト。 |
| rows[].電話番号 | 弦 | 電話番号。 |
| 行[].キャッシュ名 | 文字列|null | キャッシュされた連絡先名 (null にすることもできます)。 |
| 行[].call_date_ms | 整数 | 呼び出しタイムスタンプ(ミリ秒単位)。 |
| 行[].call_datetime_utc | 弦 | UTC 日時フィールド (データベース)。 |
| 行[].duration_sec | 整数 | 秒単位の継続時間。 |
| 行[].geo_location | 文字列|null | 地理的位置ラベル (null/空でも可)。 |
| 行[].create_at | 弦 | サーバー挿入タイムスタンプ。 |
