HTTP API (Export)
Export API는 디파이너리에 적재된 데이터를 고객사에서 직접 관리하고, 토큰을 통해 호출하여 특정 엔드포인트로 전송할 수 있으며 해당 데이터의 로그 또한 함께 확인할 수 있도록 지원하는 기능입니다. 데이터 전송 과정에서 에러 발생 시 코드를 확인하여 빠르게 대처하실 수 있습니다.
(참고 · 권장) 데이터 연동 우선순위
SDK를 활용하여 클라이언트에서 발생하는 이벤트를 연동
API를 활용하여 시스템 발생 이벤트(클라이언트에서 발생하는 이벤트 외)를 연동
S2S(Server to Server) API 활용 목적
클라이언트에서 추적이 불가능한 이벤트를 추가로 연동할 수 있도록 합니다.
단, 클라이언트에서 확보가 가능한 정보는 획득이 불가하며, S2S API로 수집한 이벤트의 경우 온사이트 캠페인의 트리거로 설정 및 활용할 수 없습니다.
*온사이트 캠페인(인앱 메시지)은 SDK를 통해 노출되는 방식 *오프사이트 캠페인의 경우 DFN 서버에서 발송하기에 무방함
데이터 전송을 위한 설정하기
경로
부가 설정 > 파트너 통합 > HTTP API (Export) 목록 > 우측 상단 API 토큰 관리 버튼 클릭 or 서비스 관리 > 서비스 정보
Export API 토큰 발급
Key 정보란에서 Export API 토큰 영역 우측에 있는 '토큰 발급' 버튼을 클릭해 토큰을 발급합니다. 클릭 한 번으로 데이터 전송을 위한 설정은 완료됩니다.
토큰 발급 / 재발급 / 삭제는 서비스 관리자만이 가능합니다.
Import API 토큰은 서비스 생성 시 자동 발급되며 재발급만이 가능합니다.
토큰 재발급은 서비스 생성 또는 재발급으로부터 최소 1일 동안 불가능합니다. (1일 기준 : 자정)
토큰 발급 시 최소 1일 동안 새로운 토큰으로의 재발급이 불가한 점 참고해주시기 바랍니다. (1일 기준 : 자정)
토큰 삭제는 언제든지 가능합니다.
토큰 삭제 및 재발급 시에는 사유를 입력해야 합니다.
토큰 재발급 시 기존 토큰의 유효 기간은 토큰 재발급으로부터 2주입니다. 이는기존 토큰으로 데이터를 주고받았을 걸 고려하여 새 토큰으로 이관하는 데 시간적 여유를 제공하기 위함입니다.
전송된 데이터 목록 제공 컬럼
상태 코드
엔드포인트
데이터
IP
일시
오류 내용
유저 에이전트
Export API 토큰
HTTP API (Export) 기능 및 제공 데이터에 관한 기술적인 안내는 API 가이드를 참고해주시기 바랍니다.
Last updated
