재사용 가능한 인증 링크
워크플로우당 하나씩 있는 장기 링크로, 방문할 때마다 새 세션을 시작합니다 - 웹사이트 버튼, QR 코드, 제휴사에 이상적입니다. vendor_data로 여러분만의 참조값을 추가하세요.
모든 워크플로우에는 방문할 때마다 새 세션을 만드는 재사용 가능한 링크가 하나씩 있습니다. 버튼 뒤에 넣거나, QR 코드로 인쇄하거나, 파트너에게 전달하세요. 자체 식별자를 ?vendor_data=로 붙이면 누구의 세션인지 구분할 수 있습니다.
#하나의 링크, 여러 사람
일회성 인증 링크는 한 사람의 것입니다. 재사용 가능한 링크는 워크플로우에 속합니다. 방문할 때마다 새 세션이 시작되므로, URL 하나를 게시해 원하는 만큼 많은 사람이 그 링크로 인증하게 할 수 있습니다.

- Copy link는 API 호출 없이 누구나 열 수 있는 URL을 제공합니다.
- 링크는 해당 워크플로우에 포함된 것을 그대로 실행하므로 먼저 기능을 확인하세요.
- 별도의 워크플로우는 별도의 링크를 만들며, 이를 통해 캠페인을 구분할 수 있습니다.
적합한 사용처:
- 웹사이트의 "신원 확인하기" 버튼
- 지점, 키오스크, 행사장에 인쇄된 QR 코드
- 제휴사, 파트너, 리셀러에게 전달하는 링크
- 누가 사용할지 미리 알 수 없는 모든 상황
#세션 구분하기
공유 링크 하나의 뻔한 문제는 결과로 생성되는 모든 세션이 익명으로 보인다는 점입니다. 자체 참조값을 붙여서 해결하세요.
https://verify.didit.me/<your-link>?vendor_data=YOUR_INTERNAL_ID
vendor_data로 전달한 값은 세션과 모든 웹훅에 그대로 돌아오므로, 조회 테이블 없이도 여러분 쪽 올바른 레코드와 결과를 매칭할 수 있습니다.
값은 사용자별로 생성하세요 - 여러분의 사용자 ID나, 여러분이 해석할 수 있는 서명된 토큰이면 됩니다. 이렇게 하면 중복 탐지도 올바르게 작동합니다. 같은 vendor_data를 공유하는 세션은 하나의 통합 사용자로 묶이므로, 재방문 고객이 자기 자신의 중복으로 표시되지 않습니다.
중복 계정 및 얼굴 검색을 참고하세요.
방문자마다 값을 동적으로 생성한다면 링크 전체를 서버 측에서 생성하세요. 사용자가 URL 바에서 수정할 수 있는 vendor_data는 사용자가 다른 사람의 ID를 넣을 수 있는 vendor_data이기도 합니다.
#재사용 가능한 링크로는 할 수 없는 것
- 개인별 만료가 없습니다. 일회성 세션 링크는 시간이 지나면 만료될 수 있지만, 재사용 가능한 링크는 계속 유지되도록 설계되어 있습니다. 특정인에게 만료되는 링크가 필요하다면 대신 단일 세션을 생성하세요.
- 사전 입력된 예상 정보가 없습니다. API로 세션을 생성할 때는 대조할 이름이나 문서 번호를 전달할 수 있습니다. 공유 링크에는 개인별 맥락이 없으므로 이런 비교는 사용할 수 없습니다.
- 누가 사용하는지 제어할 수 없습니다. 재사용 가능한 링크는 공개 URL입니다. 이를 가진 누구나 세션을 시작할 수 있으며, 웹사이트 버튼에는 적합하지만 한 사람만 사용하도록 의도한 용도에는 덜 적합합니다.
#그래도 워크플로우 비용은 그대로 발생합니다
재사용 가능한 링크를 통한 방문 하나하나가 해당 워크플로우에 대한 완전한 세션이며, 동일한 방식으로 과금됩니다. 예상보다 널리 공유된 링크는 예상보다 큰 청구서를 의미하므로, 공개적인 곳에 게시했다면 Analytics에서 사용량을 주시하세요. 분석 데이터 읽기를 참고하세요.
#어떤 워크플로우를 사용하는가
링크는 특정 애플리케이션의 특정 워크플로우에 연결되어 있으므로, 항상 그 워크플로우의 현재 게시된 버전을 실행합니다. 워크플로우를 수정하면 새 방문자가 받는 내용이 바뀌지만, 이미 진행 중인 세션은 시작할 때의 버전을 그대로 유지합니다.
#결과 받기
다른 곳과 동일합니다. 콘솔을 지켜보거나 웹훅으로 결과를 받으세요. 세션이 여러분의 API 호출에 대한 응답이 아니라 예측할 수 없이 도착하므로, 이 경우에는 폴링보다 웹훅이 훨씬 유용합니다. 세션이 생기기 전까지는 폴링할 대상 자체가 없기 때문입니다.
#전체 참고 자료
콘솔 설명은 인증 링크와 재사용 가능한 링크를 참고하세요.
