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

通話管理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 取得 https://api.smsmobileapi.com/call/outgoing/list/?apikey=YOUR_API_KEY&q=3247&date_from_ms=1700000000000&date_to_ms=1700864000000

認証

通話管理エンドポイントは、 アピキー クエリパラメータ。

サブスクリプションの検証: 受信/送信エンドポイントはAPIキーを検証し、サブスクリプションの有効性を確認します( 日付制限 >= CURDATE())。期限が切れた場合は、 api_expired不在着信エンドポイントは、状況に応じて一般的な「API キーがありません」/ サーバー エラーを返す場合があります。

共通の概念

ページネーション

使用 制限 そして オフセット 結果をページ区切りします。

タイムスタンプ

  • 通話日(ミリ秒) UNIXタイムスタンプです ミリ秒.
  • 呼び出し日時utc UTC 日時文字列 (データベース フィールド) として保存されます。
  • 不在着信の場合、APIはフォーマットされた 日付 文字列(ミリ秒の値から派生)。

検索

  • 不在着信: 検索 番号または名前と一致します。
  • 着信/発信: q phone_number または cached_name と一致します。

ソート(受信/送信のみ)

ソートは以下によって制御されます 並べ替え + ソートディレクトリ (ホワイトリストに登録されたフィールドのみ)。不在着信は常に最新のものから順に並べられます。

エラー

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&limit=100&offset=0&search=John&date_start=2026-02-01&date_end=2026-02-24

回答例

{ "success": true、 "offset": 0、 "limit": 100、 "count": 2、 "data": [ { "number": "+123470000000", "name": "John Doe", "date": "2026-02-24 12:49:39" }, { "number": "+123471111111", "name": "", "date": "2026-02-24 11:12:09" } ] }

着信 – リスト

モバイル デバイスから同期された着信応答を取得します。

終点

得るhttps://api.smsmobileapi.com/call/incoming/list/

クエリパラメータ

パラメータタイプ説明
必須アピキー APIキー。サブスクリプションに対して検証済み(日付制限).
オプション制限 整数 ページあたりの行数(デフォルト: 50、最小1、最大 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=100&offset=0&sort_by=call_date_ms&sort_dir=desc&q=3247

回答例

{ "success": true, "apikey": "YOUR_API_KEY", "limit": 100, "offset": 0, "sort_by": "call_date_ms", "sort_dir": "desc", "filters": { "date_from_ms": null, "date_to_ms": null, "q": "+12347" }, "count": 2, "rows": [ { "phone_number": "+123470000000", "cached_name": "Matteo Css", "call_date_ms": 1761233379000, "call_datetime_utc": "2026-02-23 12:49:39", "duration_sec": 440, "geo_location": "ベルギー", "created_at": "2026-02-24 04:14:38" } ] }

発信通話 – リスト

モバイル デバイスから同期された発信通話を取得します。

終点

得るhttps://api.smsmobileapi.com/call/outgoing/list/

クエリパラメータ

着信通話と同じパラメータと動作。

パラメータタイプ説明
必須アピキー APIキー。サブスクリプションに対して検証済み(日付制限).
オプション制限 整数 ページあたりの行数(デフォルト: 50、最大 200).
オプションオフセット 整数 ページ区切りオフセット(デフォルト: 0).
オプション並べ替え デフォルト 通話日(ミリ秒)。 許可された: 通話日(ミリ秒), 呼び出し日時utc, 期間_秒, 電話番号, 作成日時, キャッシュ名, 地理位置情報.
オプションソートディレクトリ 昇順|降順 デフォルト 説明.
オプション日付からミリ秒 整数(ミリ秒) このタイムスタンプ (ミリ秒) からフィルタリングします。
オプション日付からミリ秒 整数(ミリ秒) このタイムスタンプ (ミリ秒) までフィルターします。
オプションq 検索 電話番号 または キャッシュ名.

リクエストの例

GET https://api.smsmobileapi.com/call/outgoing/list/?apikey=YOUR_API_KEY&limit=50&offset=0&sort_by=duration_sec&sort_dir=desc&date_from_ms=1700000000000&date_to_ms=1700864000000

回答例

{ "success": true, "apikey": "YOUR_API_KEY", "limit": 50, "offset": 0, "sort_by": "duration_sec", "sort_dir": "desc", "filters": { "date_from_ms": "1700000000000", "date_to_ms": "1700864000000", "q": null }, "count": 1, "rows": [ { "phone_number": "+123490000000", "cached_name": null, "call_date_ms": 1761231000000, "call_datetime_utc": "2026-02-23 12:10:00", "duration_sec": 120, "geo_location": "ベルギー", "created_at": "2026-02-24 04:14:37" } ] }

不在着信フィールド

分野タイプ説明
成功ブールリクエストのステータス。
オフセット整数ページ区切りオフセットが返されます。
制限整数ページ区切りの制限が返されました。
カウント整数返される行数 データ.
データ配列不在着信のリスト。
データ[].数値発信者の電話番号。
データ[].名前キャッシュされた連絡先名(空の場合もあります)。
データ[].日付ミリ秒のタイムスタンプから派生したフォーマットされた日時文字列。

受信/送信フィールド

分野タイプ説明
成功ブールリクエストのステータス。
アピキーAPI によってエコーバックされました (キー)。
制限整数返されるページあたりの行数。
オフセット整数ページ区切りオフセットが返されます。
並べ替え並べ替えフィールドを適用しました。
ソートディレクトリ並べ替えの方向を適用しました。
フィルター物体エコーフィルター(日付からミリ秒, 日付からミリ秒, q).
カウント整数返される行数 .
配列通話のリスト。
rows[].電話番号電話番号。
行[].キャッシュ名文字列|nullキャッシュされた連絡先名 (null にすることもできます)。
行[].call_date_ms整数呼び出しタイムスタンプ(ミリ秒単位)。
行[].call_datetime_utcUTC 日時フィールド (データベース)。
行[].duration_sec整数秒単位の継続時間。
行[].geo_location文字列|null地理的位置ラベル (null/空でも可)。
行[].create_atサーバー挿入タイムスタンプ。
💬 ライブチャット
💬 ライブチャット利用可能
ご質問やサポートが必要ですか?
私たちのチームがあなたをサポートします!

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