메인 콘텐츠로 건너뛰기
노티플라이 HTTP API는 JSON over HTTPS 방식의 REST 엔드포인트로 구성됩니다.
아래 개요와 빠른 이동 카드로 주요 문서로 바로 이동하세요.

기본 정보

항목
Base URLhttps://api.notifly.tech
Media Typeapplication/json
AuthPOST /authenticate로 토큰 발급 후 Authorization 헤더에 전달
CharsetUTF-8
TimezoneISO 8601 (예: 2025-10-11T12:34:56Z)

공통 헤더

HeaderValue비고
Content-Typeapplication/json요청 본문 JSON
Authorization<auth-token>인증 토큰(로그인/세션 아님)
토큰 유효기간은 1시간. 만료 시 재발급 후 재시도하세요.

요청/응답 패턴

POST /some-endpoint HTTP/1.1
Host: api.notifly.tech
Content-Type: application/json
Authorization: <auth-token>

{ "example": "payload" }
{
  "success": true,
  "data": { "example": "response" },
  "error": null
}
에러 응답은 공통 에러 모델을 따릅니다. 자세한 필드는 Error Model 문서를 참고하세요.

인증 → 호출까지 최소 예시

// 1) 토큰 발급
const authRes = await fetch("https://api.notifly.tech/authenticate", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    accessKey: "your-access-key",
    secretKey: "your-secret-key"
  })
});
const { data: authToken } = await authRes.json();

// 2) API 호출
const res = await fetch("https://api.notifly.tech/track-event", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": authToken
  },
  body: JSON.stringify({
    projectId: "your-project-id",
    eventName: "view_home",
    isGlobalEvent: false,
    userId: "alice",
    eventParams: { plan: "premium" }
  })
});
console.log(await res.json());

빠른 이동

Authentication

토큰 발급 (POST /authenticate) — 예제 코드 포함

Error Model

표준 에러 스키마 & 상태코드 레퍼런스

이벤트 & 유저

Track Event

유저/전역 이벤트 전송

Set User Properties

유저 속성 등록/갱신(배치 지원)

Delete Users

유저 삭제(단건/다건)

캠페인/여정

Campaign

캠페인 트리거

User Journey

유저 여정 트리거

메시징

Text Message (SMS/MMS)

SMS/LMS/MMS 발송

Kakao Alimtalk

알림톡 템플릿 발송

Kakao Friendtalk

친구톡 발송

메시징 관리

Template Update

카카오 템플릿 수정

Text 080 Block Service

080 수신거부 번호 조회/등록/삭제

Export & 통계

Campaign Event Export

메시지 이벤트 데이터 내보내기

Campaign Statistics

메시지 통계 조회

Campaign Statistics Retrieval

특정 캠페인 요약/일자별 통계

User Message History

유저별 발송·수신 기록 조회