> For the complete documentation index, see [llms.txt](https://docs.dfinery.ai/api-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dfinery.ai/api-guide/authentication.md).

# 인증

DFINERY는 API 토큰을 통해 사용자가 보낸 요청이 인증된 요청인지 판단합니다. 모든 API 요청의 헤더에는 API 토큰이 필수로 포함되어야 합니다. API 토큰은 디파이너리 콘솔을 통해 발급 받을 수 있습니다.

DFINERY의 API 토큰은 Import API, Export API 토큰으로 나뉘어 있습니다. Import API 토큰은 주로 디파이너리에 고객사의 데이터를 전송할 때 사용합니다 (Event, Identity, Profile API). Export API 토큰은 주로 고객사가 디파이너리에 적재되어 있는 데이터를 추출할 때 사용합니다 (Export API).

## API 토큰 발급

[디파이너리 콘솔](https://console.dfinery.ai/)에 로그인 후 좌측 메뉴의 `서비스 관리`에 들어가시면 `Key 정보`에서 `API 토큰`을 확인할 수 있습니다 (<mark style="color:blue;">`서비스 관리`</mark> > <mark style="color:blue;">`Key 정보`</mark> > <mark style="color:blue;">`API 토큰`</mark>).

{% hint style="info" %}

* 토큰 발급 / 재발급 / 삭제는 서비스 관리자만이 가능합니다.
* API 토큰은 서비스 생성 시 자동 발급되며 재발급만이 가능합니다.
  {% endhint %}

## API 토큰을 통한 요청

### Import API

Import API 토큰은 요청 헤더에 **`access_token`** 값을 추가하여 사용할 수 있습니다.

<pre class="language-bash"><code class="lang-bash"><strong>curl -X GET "https://openapi.dfinery.ai/api/v1/..." \
</strong><strong>-H "access_token: ${your-import-api-token}"
</strong></code></pre>

### Export API

Emport API 토큰은 요청 헤더에 **`Authorization`** 값을 추가하여 사용할 수 있습니다.

```bash
curl -X GET "https://openapi.dfinery.ai/api/v1/..." \
-H "Authorization: Bearer ${your-export-api-token}"
```

## API 토큰 재발급

DFINERY에서는 서비스 별 1개의 API 토큰만 발급이 가능합니다. 만약 토큰을 변경하고 싶을 때는 재발급 버튼을 통해 변경이 가능합니다 (<mark style="color:blue;">`서비스 관리`</mark> > <mark style="color:blue;">`Key 정보`</mark> > <mark style="color:blue;">`API 토큰`</mark> > <mark style="color:blue;">`재발급`</mark>).

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

{% hint style="warning" %}
재발급 시 기존 토큰은 2주 동안만 사용이 가능합니다. 2주 내에 재발급한 토큰으로 변경해 주세요.
{% endhint %}

## API 토큰 관련 응답 코드

토큰 관련 응답 코드 및 공통 에러 및 코드는 [Response](/api-guide/api/import-api/response.md) 탭을 참고해 주시면 됩니다.