ドキュメント開発コール - SMSMobileAPI
SMSMobileAPI – 通話管理APIドキュメント

クイックスタート

ベース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_utcUTC 日時フィールド (データベース)。
行[].duration_sec整数秒単位の継続時間。
行[].geo_location文字列|null地理的位置ラベル (null/空でも可)。
行[].create_atサーバー挿入タイムスタンプ。
💬 ライブチャット
💬 ライブチャット利用可能
ご質問やサポートが必要ですか?
私たちのチームがあなたをサポートします!

メールアドレスを入力してください
お客様のリクエストに対応するために:
ダッシュボード