WNS(Windows 푸시 알림 서비스) 네이티브 알림 보내기

아티클
08/08/2024

알림 허브를 통해 WNS 기본 알림을 보냅니다.

요청

메서드	요청 URI	HTTP 버전
POST	`https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?api-version=2015-01`	HTTP/1.1

요청 헤더

다음 표에서는 필수 요청 헤더와 선택적 요청 헤더에 대해 설명합니다.

요청 헤더	Description
권한 부여	Service Bus를 사용한 공유 액세스 서명 인증에 지정된 대로 생성된 SAS 토큰입니다.
콘텐츠 형식	`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"인 경우 본문은 최대 5Kb의 텍스트입니다. 예를 들면 다음과 같습니다.

<?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>

응답

응답에는 HTTP 상태 코드 및 응답 헤더 집합이 포함되어 있습니다.

응답 코드

코드	Description
200	메시지를 보냈습니다.
400	요청의 형식이 잘못되었습니다. 예를 들어 라우팅 헤더나 콘텐츠 형식이 유효하지 않거나 메시지 크기가 초과되었거나 메시지 형식이 잘못되었습니다.
401	인증 실패 액세스 키가 잘못되었습니다.
403	할당량이 초과되었거나 메시지가 너무 큽니다. 메시지가 거부되었습니다.
404	URI에 메시지 분기가 없습니다.
413	요청한 엔터티가 너무 큽니다. 메시지 크기는 64Kb를 초과할 수 없습니다.

상태 코드에 대한 자세한 내용은 상태 및 오류 코드를 참조하세요.

응답 헤더

응답 헤더	Description
위치	이 헤더는 표준 계층 Notification Hubs에만 사용할 수 있습니다. 이 헤더에는 알림 메시지 ID가 포함됩니다. 메시지별 원격 분석 및 PNS 피드백의 상관 관계를 지정하는 데 사용됩니다. 위치 헤더는 다음 형식을 사용합니다. `https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04`

응답 본문

없음

다음을 통해 공유