例：

送信されていないSMSを再送信する

 この API エンドポイントは、未送信の SMS を再送信するために使用されます (メッセージがエラー状態の場合のみ)

終点：

パラメータ: 

例：

APIから送信されたSMSのログ  

この API エンドポイントは、API 経由で送信された SMS メッセージのログを取得するために使用されます。

終点：  

パラメータ:

例：

SMS受信

この API エンドポイントは、スマートフォンで受信した SMS メッセージを取得するために使用されます。 

終点：

パラメータ: 

例：

SMSを削除

このAPIエンドポイントは、SMSモバイルAPIのサーバーログからSMSメッセージを削除するために使用されます。

終点：  

パラメータ:

例：

注: 削除される SMS は、モバイル アプリ アカウントのログに保存されているものだけです。モバイル デバイス自体の SMS は、弊社ではアクセスできないため削除されません。

Webhook – SMS 受信

この Webhook システムは、SMS を受信するたびに、設定された URL に POST リクエストを送信します。システムは、指定された Webhook URL に SMS の詳細を配信することで、リアルタイムの更新を保証します。

ダッシュボードでWebhookを設定する方法

ダッシュボードで Webhook URL を設定するには、次の手順に従います。

1. アカウントにログインしてください SMS モバイル API ダッシュボード.
2. に移動 Webhook設定 セクション。
3. Webhook URLを入力します（例： https://example.com/webhook-endpoint
4. クリックして Webhook を保存 ボタン。 
5. 保存すると、システムは設定された URL に SMS の詳細を送信し始めます。

Webhook ペイロード

SMS を受信すると、システムは次の JSON ペイロードを Webhook URL に送信します。

{

    「日付」: 「2025-01-20」、

    "時間": "10:15:00",

    "受信時間": "2025-01-20 10:14:50",

    "message": "こんにちは、これはテストです。",

    "番号": "+123456789",

    "guid": "abcde12345"

}

ペイロードフィールド:

• 日付： SMS が追加された日付 (YYYY-MM-DD)。
• 時間： SMS が追加された時間 (HH:mm:ss)。
• 受信時間: SMS を受信した時刻。
• メッセージ： SMSの内容。 
• 番号： 送信者の電話番号。
• ガイド: SMS の一意の識別子。

Webhookエンドポイントの例

サーバーは、受信した POST リクエストを処理できる状態になっている必要があります。以下は、Webhook ペイロードを処理する PHP スクリプトの例です。

<?php

// 受信ペイロードを読み取ります

$ペイロード = file_get_contents('php://input');

$データ = json_decode($ペイロード、true);




// SMSデータを処理する

（$データ）の場合{

    // 例: SMS データをファイルに記録する

    file_put_contents('sms_log.txt', print_r($data, true), FILE_APPEND);




    // HTTP 200 ステータスで応答する

    レスポンスコード200

    echo "Webhook を正常に受信しました。";

} それ以外 {

    // 不正なリクエストに対しては HTTP 400 ステータスで応答します

    レスポンスコード400


    echo "無効なペイロードです。";

}

?>

Webhookのテスト

Webhook 構成をテストするには、次のようなツールを使用します。

• Webhook.サイト
• リクエストビン

これらのツールを使用すると、システムから送信されたペイロードを検査し、Webhook 設定に関する問題をデバッグできます。

トラブルシューティング

• Webhook URL が正しく、公開アクセス可能であることを確認します。
• 成功したリクエストに対してサーバーが HTTP 200 ステータス コードを返すことを確認します。
• ペイロードの処理中にエラーが発生していないか、サーバー ログを確認してください。

認証

SMSMobile API は、シンプルな API キーを使用するか、クライアント ID とクライアント シークレットを使用した OAuth2 プロトコルを使用する 2 つの認証方法をサポートしています。

1. APIキー認証

 このメソッドには、GET または POST リクエストのいずれかにパラメータとして含めることができる API キーが必要です。これは、API リクエストを認証する簡単な方法です。

2. OAuth2認証

OAuth2 は、より安全でスケーラブルな認証方法を提供します。
アクセストークンを取得するにはクライアントIDとクライアントシークレットを使用する必要があります。アクセストークンは、 承認 ヘッダ。

アクセストークンの取得

アクセス トークンを取得するには、クライアント ID とクライアント シークレットを使用してトークン エンドポイントに POST リクエストを送信します。

アクセストークンの使用:

アクセストークンを取得したら、それを 承認 API リクエストのヘッダー:

どの方法を使用すべきでしょうか?

- 使用 APIキー認証 迅速かつ簡単な統合を実現します。

- 使用 OAuth2認証 統合におけるセキュリティとスケーラビリティを強化します。

詳細については、完全なドキュメントを参照してください。