직접 보내기
장치 핸들 (으로 알림 형식으로 표현 된 유효한 토큰)에 직접 알림을 전송 합니다. 이 API는 사용할 수 표준 계층 알림 허브 네임 스페이스 에 고객 지원 요청에 의해 사용 하도록 설정 하는 API를 요청 했습니다. 이 API의 사용자 등록 또는 설치를 사용 하 여 필요 하지 않습니다. 대신이 api는 사용자가 직접 모든 장치를 관리 하 고 서비스를 통해 통과로 전적으로 Azure 알림 허브를 사용 하 여 다양 한 푸시 알림 서비스와 통신할 수 있습니다.
요청
메서드 | 요청 URI | HTTP 버전 |
---|---|---|
게시물 | https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?direct&api-version=2015-04 | HTTP/1.1 |
요청 헤더
다음 표에서 필수 및 선택적 요청 헤더에 설명 합니다.
응답 헤더 | 설명 |
---|---|
권한 부여 | 공유 액세스 서명 인증에 지정 된 대로 생성 된 토큰 서비스 버스, 또는 서비스 버스 인증 및 권한 부여 Microsoft Azure Active Directory 액세스 제어(액세스 제어 서비스 또는 ACS라고도 함)합니다. |
콘텐츠 형식 | 아래 대상 플랫폼 알림 서비스를 기반으로 콘텐츠 형식 헤더를 설정 합니다. - WNS의 경우: 로 설정 application/json; charset = u t f-8 또는 application/xml합니다. 로 설정 하는 알림 유형 (유형-X-WNS) "wns/raw" 이면 응용 프로그램/옥텟 스트림합니다. - GCM 및 APNS의 경우: 로 설정 application/json; charset = u t f-8합니다. - MPNS: 로 설정 application/xml; charset = u t f-8합니다. |
ServiceBusNotification DeviceHandle | PNS 장치 핸들입니다. |
ServiceBusNotification 태그 | {단일 태그 식별자} (선택 사항) |
ServiceBusNotification 형식 | 유효한 플랫폼 유형 값으로 설정 합니다. - windows - apple - gcm - windowsphone - adm - nokiax - baidu |
x ms 버전 | 2015-04 (에서 지 원하는 2015-01 이상) |
요청 본문
요청 본문 형식 플랫폼 형식에 따라 변경 됩니다. 네이티브 보내는 REST Api의 각 개별 플랫폼에 대 한 본문 형식을 참조 하십시오.
응답
응답에는 HTTP 상태 코드 및 응답 헤더 집합이 포함 됩니다. 성공 응답 본문이 반환 됩니다.
응답 코드
코드 | 설명 |
---|---|
201 | 메시지를 보냈습니다. |
400 | 요청 (예: 라우팅 헤더, 유효 하지 않은 콘텐츠 형식이 크기가 초과 된 잘못 된 메시지 형식) 형식이 잘못 되었습니다. |
401 | 권한 부여 실패입니다. 선택 키에 올바르지 않습니다. |
403 | 할당량이 초과 했거나 메시지가 너무 큽니다. 메시지가 거부 되었습니다. |
404 | URI에 메시지 분기가 없습니다. |
413 | 요청한 엔터티가 너무 큽니다. 메시지 크기는 64kb를 넘을 수 없습니다. |
상태 코드에 대 한 정보를 참조 하십시오. 상태 및 오류 코드합니다.
응답 헤더
응답 헤더 | 설명 |
---|---|
콘텐츠 형식 | 응용 프로그램/xml; charset = u t f-8 |
응답 본문
응답 본문은 있게는 NotificationOutcome
XML 형식에서입니다.
<NotificationOutcome xmlns="https://schemas.microsoft.com/netservices/2010/10/servicebus/connect" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<Success>1</Success>
<Failure>0</Failure>
<Results>
<RegistrationResult>
<ApplicationPlatform>xxx</ApplicationPlatform>
<PnsHandle>xxxxxxxxxxxxxxxxxxxxx</PnsHandle>
<RegistrationId>1233409859034-238942347293-2</RegistrationId>
<Outcome>The Notification was successfully sent to the Push Notification System</Outcome>
</RegistrationResult>
</Results>
</NotificationOutcome>
참고 항목
직접 일괄 처리 보내기
APNS 기본 알림 보내기
GCM 기본 알림 보내기
MPNS 기본 알림 보내기
WNS 기본 알림 보내기