직접 보내기
디바이스 핸들(알림 유형으로 표현된 유효한 토큰)에 직접 알림을 보냅니다. 이 API의 사용자는 등록 또는 설치를 사용할 필요가 없습니다. 대신 모든 디바이스를 자체적으로 관리하고 Azure Notification Hubs를 통과 서비스로만 사용하여 다양한 푸시 알림 서비스와 통신합니다.
중요
FCM(Firebase Cloud Messaging)은 무엇보다도 개발자가 Google Play 지원 Android 디바이스에 푸시 알림을 보낼 수 있도록 하는 서비스입니다. Azure Notification Hubs는 현재 레거시 HTTP 프로토콜을 사용하여 FCM과 통신합니다. FCM v1은 더 많은 기능과 기능을 제공하는 업데이트된 API입니다. Google은 FCM 레거시 HTTP를 더 이상 사용하지 않으며 2024년 6월 20일에 지원을 중단할 것이라고 발표했습니다. 따라서 현재 Azure Notification Hubs를 사용하여 Google Play 지원 Android 디바이스와 통신하는 개발자는 애플리케이션 및 알림 페이로드를 최신 형식으로 마이그레이션해야 합니다. Azure Notification Hubs는 Google이 요청 수락을 중지할 때까지 FCM 레거시 HTTP를 계속 지원합니다. 새 FCM 통합이 완료되면 Azure Notification Hubs에서 마이그레이션을 시작할 수 있는 시기를 알려 줍니다. 자세한 내용은 이 문서의 마이그레이션 단계를 참조하세요.
요청
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| POST | https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?direct&api-version=2015-04 |
HTTP/1.1 |
요청 헤더
다음 표에서는 필수 요청 헤더와 선택적 요청 헤더에 대해 설명합니다.
| 요청 헤더 | Description |
|---|---|
| 권한 부여 | Service Bus를 사용한 공유 액세스 서명 인증에 지정된 대로 생성된 SAS 토큰입니다. |
| 콘텐츠 형식 | 대상 플랫폼 알림 서비스를 기반으로 Content-Type 헤더를 설정합니다.
|
| ServiceBusNotification-DeviceHandle | PNS 디바이스 핸들입니다. |
| ServiceBusNotification-Tags | {단일 태그 식별자}(선택 사항) |
| ServiceBusNotification-Format | 다음 유효한 PlatformType 값 windows중 하나로 설정합니다. , , apple, gcm, windowsphone, adm, nokiax, baidu |
| x-ms-version | 2015-04(2015-01 이상 지원) |
요청 본문
플랫폼 유형에 따라 요청 본문 형식이 변경됩니다. 네이티브 SEND REST API의 각 개별 플랫폼에 대한 본문 형식을 참조하세요.
응답
응답에는 HTTP 상태 코드 및 응답 헤더 집합이 포함되어 있습니다. 응답 본문은 성공에 따라 반환됩니다.
응답 코드
| 코드 | Description |
|---|---|
| 201 | 메시지를 보냈습니다. |
| 400 | 요청의 형식이 잘못되었습니다. 예를 들어 라우팅 헤더나 콘텐츠 형식이 유효하지 않거나 메시지 크기가 초과되었거나 메시지 형식이 잘못되었습니다. |
| 401 | 인증 실패 액세스 키가 잘못되었습니다. |
| 403 | 할당량이 초과되었거나 메시지가 너무 큽니다. 메시지가 거부되었습니다. |
| 404 | URI에 메시지 분기가 없습니다. |
| 413 | 요청한 엔터티가 너무 큽니다. 메시지 크기는 64Kb를 초과할 수 없습니다. |
상태 코드에 대한 자세한 내용은 상태 및 오류 코드를 참조하세요.
응답 헤더
HTTP 1.1을 사용하는 경우 인증서 기반 인증을 사용할 때 PNS 피드백 이 작동하지 않습니다. 데이터를 반환하지 않습니다. 토큰 기반 인증을 사용합니다.
| 응답 헤더 | Description |
|---|---|
| 콘텐츠 형식 | application/xml; charset=utf-8 |
| 위치 | 이 헤더는 표준 계층 Notification Hubs에만 사용할 수 있습니다. 이 헤더에는 알림 메시지 ID가 포함됩니다. 메시지별 원격 분석: 알림 메시지 원격 분석 가져오기 및 PNS 피드백 상관 관계 지정과 함께 사용됩니다. 위치 헤더는 다음 형식을 사용합니다. https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04. |
응답 본문
없음