개발 가이드
REST API Reference

API 인증에 필요한 API KEY는 플레어레인 콘솔 내 '프로젝트' 페이지에서 확인할 수 있습니다.
클라이언트에서 API를 직접 실행하지 마세요. API KEY 노출 위험이 있습니다.
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: 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
curl --request POST 'https://api.flarelane.com/v1/projects/PROJECT_ID/notifications' \
  --header 'Authorization: Bearer API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
      "targetType": "device",
      "targetIds": ["<device-id>"],
      "title": "안녕하세요",
      "body": "반갑습니다"
  }'
curl --request POST 'https://api.flarelane.com/v1/projects/PROJECT_ID/notifications' \
  --header 'Authorization: Bearer API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
      "targetType": "device",
      "targetIds": ["<device-id>"],
      "title": "안녕하세요",
      "body": "반갑습니다"
  }'
Responses
200
{
    "data": {
        "id": "<notification-id>"
    }
}
{
    "data": {
        "id": "<notification-id>"
    }
}
﻿
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
curl --request POST 'https://api.flarelane.com/v1/projects/PROJECT_ID/events' \
  --header 'Authorization: Bearer API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
      "events": [{
        "type": "ViewProduct",
        "subjectType": "user",
        "subjectId": "abcde",
        "data": {
            "productId": "123"
        }
      }]
  }'
curl --request POST 'https://api.flarelane.com/v1/projects/PROJECT_ID/events' \
  --header 'Authorization: Bearer API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
      "events": [{
        "type": "ViewProduct",
        "subjectType": "user",
        "subjectId": "abcde",
        "data": {
            "productId": "123"
        }
      }]
  }'
Responses
200
{
    "data": {
        "success": 1,
        "error": []
    }
}
{
    "data": {
        "success": 1,
        "error": []
    }
}
﻿
태그 값은 문자열(string) 혹은 숫자(number) 타입만 입력 가능합니다.
시간 표현은 second 가 아닌 millisecond 단위의 Unix Timestamp 값을 입력합니다. (ex. 1681721331085)
해당 유저 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
curl --request PATCH 'https://api.flarelane.com/v1/projects/PROJECT_ID/users/tags' \
  --header 'Authorization: Bearer API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
      "userId": "USER-ID",
      "tags": {
        "orderCount": 5,
        "nickName": "MYNAME"
      }
  }'
curl --request PATCH 'https://api.flarelane.com/v1/projects/PROJECT_ID/users/tags' \
  --header 'Authorization: Bearer API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
      "userId": "USER-ID",
      "tags": {
        "orderCount": 5,
        "nickName": "MYNAME"
      }
  }'
Responses
200
{
    "data": {
        "devices": [
            {
                "id": "<device-id>",
                "userId": "USER-ID",
                "tags": {
                    "orderCount": 5,
                    "nickName": "MYNAME"
                }
            },
            ...
        ]
    }
}
{
    "data": {
        "devices": [
            {
                "id": "<device-id>",
                "userId": "USER-ID",
                "tags": {
                    "orderCount": 5,
                    "nickName": "MYNAME"
                }
            },
            ...
        ]
    }
}
﻿
기기로 발송된 최근 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
curl --location --request GET 'https://api.flarelane.com/v1/projects/PROJECT_ID/devices/DEVICE_ID/notification-history' \
  --header 'Authorization: Bearer API_KEY'
curl --location --request GET 'https://api.flarelane.com/v1/projects/PROJECT_ID/devices/DEVICE_ID/notification-history' \
  --header 'Authorization: Bearer API_KEY'
Responses
200
{
    "data": [
        {
            "notification": {
                "id": "NOTIFICATION_ID",
                "createdAt": "2022-12-22T10:18:00.453Z",
                "title": "NOTIFICATION_TITLE",
                "body": "NOTIFICATION_BODY",
                "url": "NOTIFICATION_URL",
                "imageUrl": "NOTIFICATION_TITLE_IMAGE_URL"
            },
            "sentAt": "2022-12-22T10:18:29.847Z"
        },
        ...
    ],
}
{
    "data": [
        {
            "notification": {
                "id": "NOTIFICATION_ID",
                "createdAt": "2022-12-22T10:18:00.453Z",
                "title": "NOTIFICATION_TITLE",
                "body": "NOTIFICATION_BODY",
                "url": "NOTIFICATION_URL",
                "imageUrl": "NOTIFICATION_TITLE_IMAGE_URL"
            },
            "sentAt": "2022-12-22T10:18:29.847Z"
        },
        ...
    ],
}
﻿
﻿
iOS 웹 푸시(Web Push) 소개 및 동작 원리
Web Push SDK Reference
Docs powered by Archbee
TABLE OF CONTENTS