메인 콘텐츠로 건너뛰기
PATCH
cURL
이 엔드포인트를 사용하면 각 애플리케이션을 그것이 나타내는 고객, 브랜드, 환경 또는 내부 사용 사례에 맞게 유지할 수 있습니다. 리셀러의 경우, 고객 간에 자격 증명을 공유하지 않고도 고객별 애플리케이션의 이름을 바꾸거나 업데이트할 수 있습니다. 직접 고객의 경우, 모든 것을 하나의 조직 아래에 두면서 제품, 리전 또는 환경을 구분하는 데 도움이 됩니다.
이 엔드포인트는 애플리케이션 메타데이터를 업데이트합니다. 자격 증명을 별도로 교체하지 않는 한 api_key는 그대로 유지됩니다.

데이터 위치

애플리케이션의 데이터 위치(data_location)는 애플리케이션을 생성할 때 선택되며 이후에는 변경할 수 없습니다. 애플리케이션이 이미 가진 위치를 지정하는 업데이트는 허용되며, 그 밖의 위치를 지정하면 400 응답이 반환됩니다. 예외는 하나입니다. 가입 시 또는 이메일 인증을 통해 조직과 함께 생성된 라이브 애플리케이션입니다. data_location을 지정하는 첫 번째 업데이트가 위치를 한 번만 선택하며, 이는 애플리케이션의 API 키가 하나도 사용되지 않았고 검증 세션이 없는 경우에 한합니다. 콘솔의 첫 애플리케이션 이름 지정 단계는 이 기능을 사용하여 여기서 선택한 위치를 저장합니다. 현재 사용 가능한 위치는 유럽 연합(아일랜드)인 eu뿐입니다.

인증

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"

본문

application/json

변경하려는 필드만 전송하십시오. PATCH 시맨틱: 누락된 필드는 유지됩니다.

애플리케이션 메타데이터를 위한 PATCH 본문입니다. 변경하려는 필드만 전송하십시오. 생략된 필드는 유지됩니다. uuid, client_id, api_key는 업데이트할 수 없습니다. products는 읽기 전용입니다. 본문의 products 키는 무시됩니다. data_location은 애플리케이션이 생성된 후에는 변경할 수 없습니다. 이미 설정된 위치를 지정하면 수락되고, 다른 위치를 지정하면 400으로 응답합니다. 유일한 예외는 조직과 함께 생성된 프로덕션 애플리케이션입니다. 애플리케이션의 API 키가 사용되지 않았고 인증 세션이 없는 동안 data_location을 지정하는 첫 번째 업데이트에서 해당 위치가 한 번 선택됩니다.

name
string

애플리케이션 표시 이름입니다.

예시:

"Acme Production App"

website_url
string

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

예시:

"https://app.acme.example"

redirect_uris
string[]

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

예시:
terms_url
string

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

privacy_url
string

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

description
string

애플리케이션에 대한 내부 설명입니다.

data_location
enum<string>

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

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

"eu"

응답

애플리케이션이 업데이트되었습니다. 응답은 products를 포함하여 변경 후의 전체 애플리케이션 레코드이며, uuid, 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일