다음을 통해 공유


직접 보내기

 

장치 핸들 (으로 알림 형식으로 표현 된 유효한 토큰)에 직접 알림을 전송 합니다. 이 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 기본 알림 보내기