# HTTP API (Export)

Export API는 디파이너리에 적재된 데이터를 고객사에서 직접 관리하고, 토큰을 통해 호출하여 특정 엔드포인트로 전송할 수 있으며 해당 데이터의 로그 또한 함께 확인할 수 있도록 지원하는 기능입니다.\
데이터 전송 과정에서 에러 발생 시 코드를 확인하여 빠르게 대처하실 수 있습니다.

## **(참고 · 권장) 데이터 연동 우선순위**

1. SDK를 활용하여 클라이언트에서 발생하는 이벤트를 연동
2. API를 활용하여 시스템 발생 이벤트(클라이언트에서 발생하는 이벤트 외)를 연동

{% hint style="success" %}
**S2S(Server to Server) API 활용 목적**

클라이언트에서 추적이 불가능한 이벤트를 추가로 연동할 수 있도록 합니다.

단, 클라이언트에서 확보가 가능한 정보는 획득이 불가하며, S2S API로 수집한 이벤트의 경우 **온사이트 캠페인의 트리거로 설정 및 활용할 수 없습니다.**

<mark style="color:purple;">\*온사이트 캠페인(인앱 메시지)은 SDK를 통해 노출되는 방식</mark>\ <mark style="color:purple;">\*오프사이트 캠페인의 경우 DFN 서버에서 발송하기에 무방함</mark>
{% endhint %}

## **데이터 전송을 위한 설정하기**

#### **경로**

부가 설정 > 파트너 통합 > HTTP API (Export) 목록 > 우측 상단 API 토큰 관리 버튼 클릭\
**or**\
서비스 관리 > 서비스 정보

### **Export API 토큰 발급**

Key 정보란에서 Export API 토큰 영역 우측에 있는 '토큰 발급' 버튼을 클릭해 토큰을 발급합니다.\
클릭 한 번으로 데이터 전송을 위한 설정은 완료됩니다.

{% hint style="info" %}

* 토큰 발급 / 재발급 / 삭제는 서비스 관리자만이 가능합니다.
* Import API 토큰은 서비스 생성 시 자동 발급되며 재발급만이 가능합니다.
* 토큰 재발급은 서비스 생성 또는 재발급으로부터 최소 1일 동안 불가능합니다.\
  (1일 기준 : 자정)
  {% endhint %}

<figure><img src="/files/T1d0aMwB1oUdREUtwiDl" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}

* 토큰 발급 시 최소 1일 동안 새로운 토큰으로의 재발급이 불가한 점 참고해주시기 바랍니다.\
  (1일 기준 : 자정)
* 토큰 삭제는 언제든지 가능합니다.
* 토큰 삭제 및 재발급 시에는 사유를 입력해야 합니다.
* 토큰 재발급 시 기존 토큰의 유효 기간은 토큰 재발급으로부터 2주입니다.\
  이는기존 토큰으로 데이터를 주고받았을 걸 고려하여 새 토큰으로 이관하는 데 시간적 여유를 제공하기 위함입니다.
  {% endhint %}

## **전송된 데이터 목록 제공 컬럼**

* 상태 코드
* 엔드포인트
* 데이터
* IP
* 일시
* 오류 내용
* 유저 에이전트
* Export API 토큰

HTTP API (Export) 기능 및 제공 데이터에 관한 기술적인 안내는 [**API 가이드**](https://docs.dfinery.ai/api-guide)를 참고해주시기 바랍니다.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dfinery.ai/user-guide/begin-to-use-dfinery/partner-setting/http-api-export.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.