Mobile Notification API Documentation

ここから開始

4 つのステップで最初のリクエストを実行します

List your connected mobiles and copy the target SID.

Create a notification with a title and message.

Poll the list endpoint by SID.

Use distribued_status and GMT timestamps to track distribution.

The secure SMSMobileAPI mobile app connecting a phone to the web dashboard and REST API for SMS and call operations — Encrypted mobile-to-platform connection

Official mobile application

The secure bridge between your phone, dashboard and API.

SMS and call operations pass through the official SMSMobileAPI app installed on your connected phone. The app securely pairs the device with your account, synchronizes authorized events and links the mobile network to the dashboard and REST API.

1Mobile appPairs the phone and its SIM 2Encrypted linkAuthenticates and protects data in transit 3Dashboard & APIControls workflows and activity

Signed releases distributed through the official Google Play and Apple App Store listings
Google and Apple platform review, signing and distribution controls
Secure device pairing, HTTPS transport and authenticated API access
Only the permissions required for the mobile features you enable

Get the official SMSMobileAPI app on Google Play

Download the official SMSMobileAPI app on the Apple App Store

Capabilities depend on the permissions and background access allowed by Android or iOS.

認証

認証情報をサーバー上に保持します

Notification endpoints use the apikey parameter. A target phone is identified by sid when sending and by sid or sidentifiant when listing.

POST · GET

Send a notification

ENDPOINThttps://api.smsmobileapi.com/notification/send

Creates an internal notification for one connected device.

いつ使用するか

Use it for operational alerts that should appear on a managed phone.

パラメータ

名前	タイプ	要件	説明
`apikey`	弦	必須	API キー。
`sid`	弦	必須	Target mobile SID.
`title`	弦	オプション	Notification title; defaults to Notification.
`message`	弦	必須	Notification content.
`type`	弦	オプション	Notification type; defaults to notification.

リクエストの例

カール

curl -X POST "https://api.smsmobileapi.com/notification/send" \
  -d "apikey=YOUR_API_KEY" \
  -d "sid=TARGET_SIDENTIFIANT" \
  --data-urlencode "title=Order ready" \
  --data-urlencode "message=Order #1042 is ready for collection."

回答例

JSON

{
  "success": true,
  "message": "Notification created.",
  "id": 22087,
  "apikey": "YOUR_API_KEY",
  "sid": "508b004b4aadacc4"
}

これを実行したいrequest? Connect your API key at the top of the page to unlock the interactive tester.

接続キー ↑

Good to know

Creation and distribution are separate events. Use the list endpoint to verify delivery to the device.

得る

List notifications

ENDPOINThttps://api.smsmobileapi.com/notification/list/

Returns up to 200 notifications ordered from newest to oldest.

いつ使用するか

Use it to monitor distribution and build a notification history.

パラメータ

名前	タイプ	要件	説明
`apikey`	弦	必須	API キー。
`sidentifiant`	弦	オプション	Filter by target mobile.
`sid`	弦	オプション	Alias of sidentifiant.
`distribued`	0 \| 1	オプション	1 for distributed, 0 for not distributed.
`date_from`	年-月-日	オプション	Start date.
`date_to`	年-月-日	オプション	End date.

リクエストの例

カール

curl "https://api.smsmobileapi.com/notification/list/?apikey=YOUR_API_KEY&sidentifiant=TARGET_SIDENTIFIANT&distribued=1"

回答例

JSON

{
  "success": true,
  "count": 1,
  "data": [{
    "sidentifiant": "508b004b4aadacc4",
    "title": "Order ready",
    "message": "Order #1042 is ready for collection.",
    "distribued": "1",
    "distribued_status": "distributed",
    "distributed_at_gmt": "2026-03-18 10:18:30",
    "distributed_at_unix": 1773829110,
    "sent_at_gmt": "2026-03-18 10:15:03",
    "sent_at_unix": 1773828903
  }]
}

これを実行したいrequest? Connect your API key at the top of the page to unlock the interactive tester.

接続キー ↑

Good to know

All sent and distributed timestamps are GMT.

トラブルシューティング

エラーと安全な再試行

再試行する前に、HTTP ステータスと JSON エラーフィールドを読み取ります。最初にリクエストを修正せずに、検証または認証の失敗を再試行しないでください。

HTTP	コード	対処方法
400	`Missing required param`	apikey, sid or message is missing.
400	`Invalid date format`	Use YYYY-MM-DD for date_from and date_to.
400	`Invalid distribued value`	Only 0 or 1 is accepted.
500	`DB connection / query failed`	The notification service could not complete the operation.

再試行ルール一時的な 429 応答と 5xx 応答のみを再試行します。 1 秒後に開始し、2 秒、4 秒、8 秒に戻ります。

ヘルプが必要ですか?

シークレットではなくリクエストコンテキストを提供します。

エンドポイント、タイムスタンプ、HTTP ステータス、サニタイズされたレスポンスを共有します。 API キー、トークン、プライベートメッセージコンテンツは決して含めないでください。

API サポートに問い合わせる →

Notification API documentation

4 つのステップで最初のリクエストを実行します

The secure bridge between your phone, dashboard and API.

認証情報をサーバー上に保持します

パラメータ

リクエストの例

回答例

パラメータ

リクエストの例

回答例

エラーと安全な再試行

シークレットではなくリクエスト コンテキストを提供します。

シークレットではなくリクエストコンテキストを提供します。