인증

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

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

API 토큰 발급

디파이너리 콘솔에 로그인 후 좌측 메뉴의 서비스 관리에 들어가시면 Key 정보에서 API 토큰을 확인할 수 있습니다 (서비스 관리 > Key 정보 > API 토큰).

• 토큰 발급 / 재발급 / 삭제는 서비스 관리자만이 가능합니다.

• API 토큰은 서비스 생성 시 자동 발급되며 재발급만이 가능합니다.

API 토큰을 통한 요청

Import API

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

curl -X GET "https://openapi.dfinery.ai/api/v1/..." \
-H "access_token: ${your-import-api-token}"

Export API

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

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

API 토큰 재발급

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

재발급 시 기존 토큰은 2주 동안만 사용이 가능합니다. 2주 내에 재발급한 토큰으로 변경해 주세요.

API 토큰 관련 응답 코드

토큰 관련 응답 코드 및 공통 에러 및 코드는 Response 탭을 참고해 주시면 됩니다.