MPNS(Microsoft 푸시 알림 서비스) 네이티브 알림 보내기
알림 허브를 통해 MPNS 기본 알림을 보냅니다.
중요
MPNS(Microsoft 푸시 알림 서비스)는 더 이상 사용되지 않으며 지원하지 않습니다.
요청
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| POST | https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?api-version=2015-01 |
HTTP/1.1 |
요청 헤더
다음 표에서는 필수 요청 헤더와 선택적 요청 헤더에 대해 설명합니다.
| 요청 헤더 | Description |
|---|---|
| 권한 부여 | Service Bus를 사용한 공유 액세스 서명 인증에 지정된 대로 생성된 SAS 토큰입니다. |
| 콘텐츠 형식 |
application/xml;charset=utf-8로 설정합니다. |
| ServiceBusNotification-Tags |
{single tag identifier}(선택 사항) |
| ServiceBusNotification-Format |
windowsphone
|
| X-* | X-로 시작하는 모든 헤더가 MPNS로 전달됩니다. Windows Phone 8에 대한 푸시 알림을 참조하세요. |
요청 본문
요청 본문은 MPNS에서 지정한 XML 문서입니다. 알림이 원시 알림인 경우 본문은 최대 1Kb의 텍스트입니다. 예를 들면 다음과 같습니다.
<?xml version="1.0" encoding="utf-8"?>
<wp:Notification xmlns:wp="WPNotification" Version="2.0">
<wp:Tile Id="[Tile ID]" Template="IconicTile">
<wp:SmallIconImage [Action="Clear"]>[small Tile size URI]</wp:SmallIconImage>
<wp:IconImage Action="Clear">[medium/wide Tile size URI]</wp:IconImage>
<wp:WideContent1 Action="Clear">[1st row of content]</wp:WideContent1>
<wp:WideContent2 Action="Clear">[2nd row of content]</wp:WideContent2>
<wp:WideContent3 Action="Clear">[3rd row of content]</wp:WideContent3>
<wp:Count Action="Clear">[count]</wp:Count>
<wp:Title Action="Clear">[title]</wp:Title>
<wp:BackgroundColor Action="Clear">[hex ARGB format color]</wp:BackgroundColor>
</wp:Tile>
</wp:Notification>
응답
응답에는 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 |
응답 본문
없음