메인 콘텐츠로 건너뛰기
POST
curl

인증

x-api-key
string
header
필수

Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본 키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며 특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된 IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write 권한이 없는 키는 세션 링크와 token을 null로 수신합니다. https://docs.didit.me/console/api-keys 를 참고하십시오.

본문

application/json
wallet_address
string

검증할 지갑 주소입니다. 선택 사항이며, 비어 있는 경우 증명을 시작할 때 주소를 제공해야 합니다.

Maximum string length: 128
chain
string

해당 주소의 체인 token(예: ETH, BTC 또는 SOL)입니다. 지갑 주소록에서 사용하는 것과 동일한 token을 사용하십시오. 메시지 서명 및 사토시 테스트는 지원되는 체인에 대해서만 제공됩니다. 증명이 검증하는 주소록 항목은 표준 식별자(ETH, BTC, SOL, TRX)로 이를 저장합니다.

Maximum string length: 32
holder_name
string

수취인 이름 대조에 사용되는 지갑 보유자 이름입니다.

Maximum string length: 255
vendor_data
string

보유자에 대한 귀하의 내부 식별자이며, 생성된 주소록 항목으로 전달됩니다.

Maximum string length: 255
transaction_id
string<uuid> | null

선택 사항입니다. 증명이 검증될 때 진행할 Travel Rule 전송의 Didit 거래 UUID입니다.

satoshi_deposit_address
string

선택 사항입니다. 귀하가 관리하는 입금 주소이며, 이를 제공하면 SATOSHI_TEST 증명 방법이 활성화됩니다.

Maximum string length: 128
callback_url
string

선택 사항입니다. 완료 후 위젯이 고객을 리디렉션할 절대 http(s) URL입니다.

Maximum string length: 512
expires_in_minutes
integer
기본값:60

선택 사항입니다. 발급된 링크의 유효 기간(분 단위)입니다. SATOSHI_TEST가 제공되는 경우 사토시 테스트 기간을 포함하도록 자동으로 연장됩니다.

필수 범위: 5 <= x <= 10080

응답

발급된 위젯 세션입니다.

widget_session_id
string<uuid>
token
string

위젯 URL에 포함된 불투명 세션 token입니다.

url
string

호스팅 지갑 소유권 위젯 URL입니다. 시스템 브라우저에서 그대로 엽니다(모바일 SDK 웹뷰 내에서는 절대 열지 마세요).

expires_at
string<date-time>
마지막 수정일 2026년 11월 7일