Push Notification REST API

• Push Notification API
  • get토큰 조회
  • post토큰 등록
  • post푸시 알림 전송
  • get푸시 결과 조회
  • del토큰 삭제
• Console API
  • get알림 발송 조회 리스트
  • put요청한 알림 전송 수정
  • post앱의 모든 유저에게 Push 알림 전송
  • del요청한 알림 전송 취소
  • putiOS(APNs) 인증키(.p8) 등록
  • putiOS(APNs) 인증서(.p12) 등록
  • put안드로이드 Package Name, Server Key 등록
  • get알림 정보 조회

API docs by Redocly

Maxst Notification API Document (v0.1)

Download OpenAPI specification:Download

Maxst Notification API

Push Notification API

푸시 관련 기능

토큰 조회

유저 ID를 이용해 토큰 정보 확인

Authorizations:

Authorization

query Parameters

user_id required

string

Responses

http://localhost:8082/v1/push/token

https://alpha-api.maxst.com/noti/v1/push/token

토큰 등록

유저의 토큰을 저장, 기존에 등록되지 않은 유저라면 새로 생성, 등록된 유저라면 토큰이 추가됩니다

Authorizations:

Authorization

Request Body schema: application/json

user_id required	string 사용자 ID
push_type required	string [ 0 .. 10 ] characters 토큰의 push type(ANDROID, IOS)
push_token required	string\S+ 구글에서 발급 받은 push key

Responses

http://localhost:8082/v1/push/token

https://alpha-api.maxst.com/noti/v1/push/token

Request samples

• Payload

Content type

application/json

{

• "user_id": "user1",
• "push_type": "ANDROID",
• "push_token": "eYyyyyyyy"

}

푸시 알림 전송

유저 정보를 바탕으로 푸시 알림을 보냄

Authorizations:

Authorization

Request Body schema: application/json

recipient_ids required	Array of strings 수신할 사용자 ID
push_type required	string 토큰의 push type(ANDROID | IOS)
title required	string 제목
body required	string 제목
	object 데이터

Responses

http://localhost:8082/v1/push/send

https://alpha-api.maxst.com/noti/v1/push/send

Request samples

• Payload

Content type

application/json

{

• "recipient_ids": [

  • "user1",
  • "user2"

  ],
• "push_type": "ANDROID",
• "title": "푸시 제목입니다.",
• "body": "푸시 내용입니다.",
• "data": {

  • "body": "===test data==="

  }

}

푸시 결과 조회

Authorizations:

Authorization

path Parameters

transaction_id required

string

Responses

http://localhost:8082/v1/push/transaction/{transaction_id}

https://alpha-api.maxst.com/noti/v1/push/transaction/{transaction_id}

토큰 삭제

등록된 유저의 토큰 삭제

Authorizations:

Authorization

path Parameters

push_token required

string

query Parameters

user_id required

string

Responses

http://localhost:8082/v1/push/token/{push_token}

https://alpha-api.maxst.com/noti/v1/push/token/{push_token}

Console API

콘솔 관련 기능

알림 발송 조회 리스트

Page 형식으로 조회

Authorizations:

Authorization

query Parameters

application_id required	string
page	integer <int32> Default: 1
size	integer <int32> Default: 10

Responses

http://localhost:8082/v1/console/push/send

https://alpha-api.maxst.com/noti/v1/console/push/send

요청한 알림 전송 수정

아직 전송되지 않은 알림 요청에 대해 수정

Authorizations:

Authorization

query Parameters

application_id required	string
request_uuid required	string

Request Body schema: application/json

title required	string 제목
body required	string 내용
dispatch_type required	string 발송 유형(IMMEDIATE, SCHEDULED, RECURRING), 현재 반복 발송은 지원 안함
destination required	Array of strings 발송 대상(ANDROID, IOS), 현재 IOS 발송은 지원 안함
dispatch_date	string\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2} 예약 발송 시간

Responses

http://localhost:8082/v1/console/push/send

https://alpha-api.maxst.com/noti/v1/console/push/send

Request samples

• Payload

Content type

application/json

{

• "title": "테스트 알림 제목입니다.",
• "body": "테스트 알림 내용입니다.",
• "dispatch_type": "SCHEDULED",
• "destination": [

  • "ANDROID"

  ],
• "dispatch_date": "2023-06-07T13:46:08"

}

앱의 모든 유저에게 Push 알림 전송

안드로이드, iOS에 알림 전송

현재 기준으로 반복 전송(RECURRING), iOS 알림 지원 안됨

Authorizations:

Authorization

query Parameters

application_id required

string

Request Body schema: application/json

title required	string 제목
body required	string 내용
dispatch_type required	string 발송 유형(IMMEDIATE, SCHEDULED, RECURRING), 현재 반복 발송은 지원 안함
destination required	Array of strings 발송 대상(ANDROID, IOS), 현재 IOS 발송은 지원 안함
dispatch_date	string\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2} 예약 발송 시간

Responses

http://localhost:8082/v1/console/push/send

https://alpha-api.maxst.com/noti/v1/console/push/send

Request samples

• Payload

Content type

application/json

{

• "title": "테스트 알림 제목입니다.",
• "body": "테스트 알림 내용입니다.",
• "dispatch_type": "SCHEDULED",
• "destination": [

  • "ANDROID"

  ],
• "dispatch_date": "2023-06-07T13:46:08"

}

요청한 알림 전송 취소

아직 전송되지 않은 알림 요청을 삭제

Authorizations:

Authorization

query Parameters

application_id required

string

Request Body schema: application/json

request_uuids required

Array of strings 앱 푸시 요청 id List

Responses

http://localhost:8082/v1/console/push/send

https://alpha-api.maxst.com/noti/v1/console/push/send

Request samples

• Payload

Content type

application/json

{

• "request_uuids": [

  • "2c76b996-92bb-44a7-a9a3-9559aa63c9cf",
  • "a8bcbf65-7fa5-4c03-bc88-1c23db82615d"

  ]

}

iOS(APNs) 인증키(.p8) 등록

iOS push를 위해 해당 config 등록

Authorizations:

Authorization

query Parameters

application_id required	string
bundle_id required	string
team_id required	string
key_id required	string

Request Body schema: multipart/form-data

auth_key_file

string <binary> multipart/form-data 형식의 파일을 받습니다.

Responses

http://localhost:8082/v1/console/push/config/apns/key

https://alpha-api.maxst.com/noti/v1/console/push/config/apns/key

iOS(APNs) 인증서(.p12) 등록

iOS push를 위해 해당 config 등록

Authorizations:

Authorization

query Parameters

application_id required	string
apns_certificate_password required	string

Request Body schema: multipart/form-data

certificate_file

string <binary> multipart/form-data 형식의 p12 파일을 받습니다.

Responses

http://localhost:8082/v1/console/push/config/apns/certificate

https://alpha-api.maxst.com/noti/v1/console/push/config/apns/certificate

안드로이드 Package Name, Server Key 등록

안드로이드 push를 위한 설정 등록

Authorizations:

Authorization

query Parameters

application_id required

string

Request Body schema: application/json

package_name required	string 안드로이드 패키지 네임
fcm_server_key required	string FCM API Server Key

Responses

http://localhost:8082/v1/console/push/config/android

https://alpha-api.maxst.com/noti/v1/console/push/config/android

Request samples

• Payload

Content type

application/json

{

• "package_name": "test.android",
• "fcm_server_key": "AAAAHsTKWxk:APA91bEPgHec6BW9TClrMthtCU0P0o2cTBd0NDEumkuBuUfRfL3xJWI96tWvM0TfuNU3U52uHc5vyIHbxb3hR5yoG0FYgP1Z_yTYtyn7St8TJSjxhfV5kmm77UZ7gi8lVDXU_5UUzKZK"

}

알림 정보 조회

알림 정보 조회(상태, 인증 정보, iOS 인증 정보)

Authorizations:

Authorization

query Parameters

application_id required

string

Responses

http://localhost:8082/v1/console/push/config

https://alpha-api.maxst.com/noti/v1/console/push/config