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

  • [アーティクル]

通知ハブを経由して 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

応答本文

[なし] :

参照