메인 콘텐츠로 건너뛰기
POST
cURL
같은 조직 안에서 인증 트래픽, 자격 증명, 브랜딩 또는 리포팅을 분리해야 할 때 이 endpoint를 사용합니다. 고객마다 애플리케이션을 하나씩 생성하는 리셀러에게 특히 유용합니다. 또한 자사에 여러 제품, 브랜드, 지역, 스테이징/프로덕션 환경 또는 같은 API 키와 애플리케이션 수준 설정을 공유해서는 안 되는 사용 사례가 있는 경우에도 잘 맞습니다.
모든 Auth API endpoint는 https://apx.didit.me/auth/v2를 사용합니다. 반환된 api_key를 세션 및 워크플로 같은 https://verification.didit.me/v3/... endpoint를 호출할 때 x-api-key로 사용하십시오.

데이터 위치

각 애플리케이션은 인증 데이터를 한 곳, 즉 데이터 위치에 저장하고 처리합니다. 데이터 위치는 애플리케이션을 생성할 때 data_location으로 선택합니다. 현재 사용할 수 있는 위치는 eu, 즉 유럽연합(아일랜드)뿐이며, 이 필드를 생략하면 이 위치가 기본값으로 적용됩니다. 호주(시드니, au)와 멕시코(mx)는 곧 제공될 예정입니다. 이 위치를 지정한 요청은 400 This data location is not available yet. 응답을 반환하며 아무것도 생성하지 않습니다. 애플리케이션을 조회할 때마다 data_location이 반환되며, 애플리케이션을 생성한 후에는 변경할 수 없습니다. 자세한 내용은 데이터 위치를 참조하십시오.

인증

Authorization
string
header
필수

POST /programmatic/login/ 또는 POST /programmatic/verify-email/에서 반환된 RS256으로 서명된 JWT access_token입니다. Authorization: Bearer <access_token> 형태로 전송합니다. 기본 유효 기간은 86400초(24시간)입니다. 이 token은 apx.didit.me/auth/v2의 계정 관리 endpoint에 대해서만 유효합니다. 인증 API(verification.didit.me/v3)는 대신 장기 api_key를 x-api-key로 사용합니다.

경로 매개변수

org_id
string<uuid>
필수

조직의 UUID입니다. GET /organizations/me/로 조회하십시오.

예시:

"a1b2c3d4-5678-90ab-cdef-111111111111"

본문

application/json

모든 필드는 선택 사항입니다. body를 생략하면 기본 이름이 "<organization name> App"이고 공개 URL이 구성되지 않은 애플리케이션이 생성됩니다.

모든 필드는 선택 사항입니다. 빈 body를 전송하면 유럽 연합에 기본 이름을 가진 애플리케이션이 생성됩니다.

name
string

애플리케이션 표시 이름입니다. 기본값은 "<organization name> App"입니다.

예시:

"Acme Customer App"

website_url
string

이 애플리케이션과 연결된 웹사이트 또는 앱 URL입니다.

예시:

"https://acme.example"

redirect_uris
string[]

OAuth 스타일 및 인증 리디렉션 워크플로에 허용된 리디렉션 URI입니다.

예시:
terms_url
string

인증 흐름에 표시되는 서비스 이용약관 URL입니다.

예시:

"https://acme.example/terms"

privacy_url
string

인증 플로우에 표시되는 개인정보 처리방침 URL입니다.

예시:

"https://acme.example/privacy"

description
string

애플리케이션에 대한 내부 설명(최종 사용자에게는 표시되지 않음).

data_location
enum<string>

애플리케이션의 인증 데이터가 저장되고 처리되는 위치로, 애플리케이션 생성 시 선택됩니다. 기본값은 eu인 유럽 연합(아일랜드)입니다. au(호주, 시드니) 및 mx(멕시코)는 곧 지원될 예정입니다. 해당 위치를 지정한 요청에는 400 This data location is not available yet. 응답이 반환됩니다. 조직의 샌드박스 애플리케이션은 항상 유럽 연합에 위치합니다.

사용 가능한 옵션:
eu,
au,
mx
예시:

"eu"

응답

애플리케이션이 생성되었습니다. 응답에는 장기 유효 api_key가 포함됩니다. 지금 이를 저장하고 모든 https://verification.didit.me/v3/... 호출에서 x-api-key 헤더로 사용하십시오.

전체 애플리케이션 레코드입니다. uuid, client_id, api_key는 생성 후 절대 변경되지 않습니다. data_location 역시 변경되지 않으나, 조직과 함께 생성된 라이브 애플리케이션에서 사용 전 한 번만 변경할 수 있습니다(업데이트 요청 참조).

uuid
string<uuid>

애플리케이션 UUID입니다. 후속 호출에서 {app_id}로 사용합니다.

예시:

"b2c3d4e5-6789-01bc-defg-222222222222"

name
string

Didit 콘솔에 표시되는 애플리케이션 표시 이름입니다.

예시:

"Acme Production App"

client_id
string

OAuth 스타일 플로우에 안전하게 삽입할 수 있는 공개 클라이언트 식별자입니다.

예시:

"S9LIYGSoWNuGMLHsvEt9dQ"

api_key
string

장기간 유지되는 시크릿(client_secret이라고도 함). https://verification.didit.me/v3/...에 대한 모든 호출(세션, 워크플로, AML 등)의 x-api-key 헤더로 사용합니다. 자격 증명으로 취급해야 하며 클라이언트 측에 절대 노출하지 마십시오. 새 키는 sk_live_(프로덕션 애플리케이션) 또는 sk_test_(샌드박스 애플리케이션)로 시작하며 그 뒤에 URL에 안전한 43자리 문자(영문자, 숫자, - 및 _)가 옵니다. 이 형식 이전에 생성된 키에는 접두사가 없으며 변경 없이 계속 작동합니다. 계정을 복구한 후 72시간 동안 목록 조회, 단건 조회, 수정 시 키 대신 빈 문자열이 반환됩니다.

예시:

"sk_live_example_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

website_url
string | null

이 애플리케이션과 연결된 웹사이트 또는 앱 URL입니다.

예시:

"https://acme.example"

redirect_uris
string[]

OAuth 스타일 및 인증 리디렉션 워크플로에 허용된 리디렉션 URI입니다.

예시:
terms_url
string | null

인증 흐름에 표시되는 서비스 이용약관 URL입니다.

예시:

"https://acme.example/terms"

privacy_url
string | null

인증 플로우에 표시되는 개인정보 처리방침 URL입니다.

예시:

"https://acme.example/privacy"

description
string | null

애플리케이션에 대한 내부 설명(최종 사용자에게는 표시되지 않음).

created_at
string<date-time>
예시:

"2025-06-01T10:00:00Z"

data_location
enum<string>

애플리케이션의 인증 데이터가 저장되고 처리되는 위치로, 애플리케이션 생성 시 선택됩니다. 기본값은 eu인 유럽 연합(아일랜드)입니다. au(호주, 시드니) 및 mx(멕시코)는 곧 지원될 예정입니다. 해당 위치를 지정한 요청에는 400 This data location is not available yet. 응답이 반환됩니다. 조직의 샌드박스 애플리케이션은 항상 유럽 연합에 위치합니다.

사용 가능한 옵션:
eu,
au,
mx
예시:

"eu"

products
object[]
read-only

애플리케이션의 제품입니다. 항상 세 가지 모두 다음 순서로 포함됩니다: identity, transactions, authentication. 새 애플리케이션은 identity가 모든 모듈과 함께 활성화되어 있고, transactions 및 authentication은 비활성화되어 있습니다. 읽기 전용: 생성 또는 업데이트 본문의 products 키는 무시됩니다.

예시:
마지막 수정일 2026년 11월 7일