메인 콘텐츠로 건너뛰기
GET
cURL

인증

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입니다.

예시:

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

app_id
string<uuid>
필수

자격 증명을 읽으려는 애플리케이션의 UUID입니다.

예시:

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

응답

client_id 및 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일