본문으로 건너뛰기

푸시 알림 REST API

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

Response samples

Content type
application/json;charset=UTF-8
{
  • "user_id": "user01",
  • "token_list": [
    ]
}

토큰 등록

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

Authorizations:
Authorization
Request Body schema: application/json;charset=UTF-8
user_id
required
string

사용자 ID

push_type
required
string [ 0 .. 10 ] characters

토큰의 push type(ANDROID, IOS)

push_token
required
string\S+

구글에서 발급 받은 push key

Responses

Request samples

Content type
application/json;charset=UTF-8
{
  • "user_id": "user1",
  • "push_type": "ANDROID",
  • "push_token": "eYyyyyyyy"
}

Response samples

Content type
application/json;charset=UTF-8
201

푸시 알림 전송

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

Authorizations:
Authorization
Request Body schema: application/json;charset=UTF-8
recipient_ids
required
Array of strings

수신할 사용자 ID

push_type
required
string

토큰의 push type(ANDROID | IOS)

title
required
string

제목

body
required
string

제목

object

데이터

Responses

Request samples

Content type
application/json;charset=UTF-8
{
  • "recipient_ids": [
    ],
  • "push_type": "ANDROID",
  • "title": "푸시 제목입니다.",
  • "body": "푸시 내용입니다.",
  • "data": {
    }
}

Response samples

Content type
application/json;charset=UTF-8
{
  • "transactions": [
    ]
}

푸시 결과 조회

Authorizations:
Authorization
path Parameters
transaction_id
required
string

Responses

Response samples

Content type
application/json;charset=UTF-8
{
  • "request_id": "010c01887c18226c-24e00a60-1f81-44e8-b6c2-c7c3024a7ed2-000000",
  • "transaction_at": "2023-06-02T12:32:16+09:00[Asia/Seoul]",
  • "recipient_id": "sichoi@maxst.com",
  • "transaction_id": "b27fbcd2-8859-4ce8-bc29-175042ec039a",
  • "status": "SUCCESS"
}

토큰 삭제

등록된 유저의 토큰 삭제

Authorizations:
Authorization
path Parameters
push_token
required
string
query Parameters
user_id
required
string

Responses

Response samples

Content type
application/json;charset=UTF-8
200