Windows プッシュ通知サービス (WNS) ネイティブ通知を送信する

[アーティクル]
05/26/2023

通知ハブを経由して WNS ネイティブ通知を送信します。

Request

Method	要求 URI	HTTP バージョン
POST	`https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?api-version=2015-01`	HTTP/1.1

要求ヘッダー

必須要求ヘッダーと省略可能な要求ヘッダーを次の表に示します。

要求ヘッダー	説明
承認	Service Bus を使用した Shared Access Signature Authentication で指定されたとおりに生成された SAS トークン。
Content-Type	`application/json;charset=utf-8` または `application/xml` に設定します。通知の種類 (`X-WNS-Type`) がの場合は `wns/raw`、に設定します `application/octet-stream`。
ServiceBusNotification-Tags	`{single tag identifier}` (省略可)
ServiceBusNotification-Format	`windows`
X-WNS-	X-WNS で始まるヘッダーはすべて WNS に転送されます。

要求本文

要求本文は、 WNS で指定された XML ドキュメントです。通知の種類が "wns/raw" の場合、本文は 5 Kb までの任意のテキストです。次に例を示します。

<?xml version="1.0" encoding="utf-8" ?>
<toast>
    <visual lang="en-US">
        <binding template="ToastText01">
            <text id="1">
                This is my toast message for Win8!
            </text>
        </binding>
    </visual>
</toast>

Response

応答には、HTTP 状態コードおよび一連の応答ヘッダーが含まれています。

応答コード

コード	説明
200	メッセージは正常に送信されました。
400	要求の形式が正しくありません (たとえば、ルーティングヘッダーが無効である、コンテンツの種類が無効である、メッセージのサイズが超過している、メッセージ形式が間違っている)。
401	認証エラー。アクセスキーが正しくありませんでした。
403	クォータを超過したか、メッセージが大きすぎます。メッセージは拒否されました。
404	URI にメッセージブランチがありません。
413	要求されたエンティティが大きすぎます。メッセージサイズは 64 Kb を超えることはできません。

状態コードの詳細については、「状態コードとエラーコード」を参照してください。

応答ヘッダー

応答ヘッダー	説明
場所	このヘッダーは、 Standard レベルの Notification Hubs でのみ使用できます。このヘッダーには、通知メッセージ ID が含まれます。これは、メッセージごとのテレメトリと PNS フィードバックの関連付けで使用されます。 location ヘッダーは、次の形式を使用します。 `https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04`

応答本文

[なし] :

Share via