REST API Reference
API 인증에 필요한 API KEY는 플레어레인 콘솔 내 '프로젝트' 페이지에서 확인할 수 있습니다.
클라이언트에서 API를 직접 실행하지 마세요. API KEY 노출 위험이 있습니다.
무료 플랜(스타터)의 경우 분당 100회까지의 API 요청 제한이 있습니다. 유료 플랜 전환 시 무제한 사용이 가능합니다.
POST
Params
Path Params
PROJECT_ID
required
String
프로젝트 ID
Header Parameters
Authorization
required
String
발급된 API KEY
ex) Bearer API_KEY
Body Parameters
targetType
required
String
발송 대상 유형 (segment, userId, device)
targetIds
required
Array
발송 대상의 id 배열
* targetType별 최대 개수
- segment: 5개
- userId,device: 1개(팀 플랜 이상 100개)
templateId
optional
String
템플릿 id. 템플릿 사용시 다른 파라미터가 함께 있어도 템플릿의 내용으로 대체됩니다.
title
optional
String
메시지 제목
body
optional
String
메시지 내용. templateId 와 body 중 하나는 반드시 존재해야 합니다.
url
optional
String
메시지 URL
imageUrl
optional
String
첨부할 이미지 URL
data
optional
Object
{key:value} 형태의 추가 변수 제공
Curl
|
RESPONSES
200
|
해당 유저 ID와 일치하는 기기들을 모두 찾아 태그 변경
PATCH
Params
Path Params
PROJECT_ID
required
String
프로젝트 ID
Header Parameters
Authorization
required
String
발급된 API KEY
ex) Bearer API_KEY
Body Parameters
userId
required
String
기기를 검색할 기준 User ID
tags
required
Object
{key:value} 형태의 태그 (null value 시 태그 삭제)
Curl
|
RESPONSES
200
|
기기로 발송된 최근 30일 동안의 알림 내역을 확인할 수 있습니다. 해당 데이터로 서비스 내 알림함을 구축할 수 있습니다.
GET
Params
Path Params
PROJECT_ID
required
String
프로젝트 ID
DEVICE_ID
required
String
기기 ID
Header Parameters
Authorization
required
String
발급된 API KEY
ex) Bearer API_KEY
Curl
|
RESPONSES
200
|
POST
Params
Path Params
PROJECT_ID
required
String
프로젝트 ID
Header Parameters
Authorization
required
String
발급된 API KEY
ex) Bearer API_KEY
Body Parameters
events
required
Array
Event 객체 배열
events[]
required
Object
Event 객체 타입 정의
Curl
|
RESPONSES
200
|