연동 방법: API, SDK, 노코드 링크
코드를 작성하지 않아도 Didit으로 신원 확인을 시작할 수 있습니다 - 노코드 링크를 사용하거나, 자동화가 필요할 때 SDK나 API를 도입하세요.
세 가지 경로가 있습니다. 노코드 링크는 백엔드가 전혀 필요 없습니다. API와 리디렉션의 조합은 표준적인 연동 방식입니다. SDK는 플로우를 여러분의 앱 안에 넣는 방식이며, NFC를 지원하는 유일한 경로입니다. 어떤 방식을 선택하든 웹훅으로 결과를 받으세요.
Didit으로 신원 확인을 시작하는 데 개발자가 꼭 필요하지는 않습니다. 몇 분이면 끝나는 노코드 옵션이 있고, 자체 제품 안에서 자동화하고 싶을 때를 위한 API와 SDK 옵션도 있습니다.
#코딩 없이 Didit을 사용할 수 있나요?
가능합니다. 콘솔에서 워크플로우를 구성했다면, 코드 없이 두 가지 방법으로 인증 세션을 생성할 수 있습니다.
- 1단계는 백엔드가 인증에 사용할 API 키를 발급합니다.
- 2단계는 각 세션이 실행할 워크플로우를 선택합니다.
- 3단계는 결과를 전달받을 위치를 등록하고 테스트 전송을 보냅니다.
- 4단계는 코드입니다: 사용 중인 스택에 맞는 퀵스타트를 복사하세요.
- 인증 링크(일회성)
Workflows 페이지에서 콘솔에서 직접 세션을 생성합니다. 그 사람만을 위한 고유한 URL과 QR 코드가 생성되며, 이메일이나 SMS 등 어떤 채널로든 보내거나 현장에서 코드를 스캔하게 할 수 있습니다.
- 재사용 가능한 링크(Unilink)
각 워크플로우에는 방문할 때마다 새 세션을 시작하는 재사용 가능한 링크도 하나씩 있습니다. 사이트의 버튼 뒤에 넣거나, 키오스크나 지점용 QR 코드로 인쇄하거나, 제휴사와 공유하세요. 재사용 가능한 링크를 참고하세요.
두 방법 모두 API와 백엔드를 완전히 건너뜁니다 - MVP, 수동 검토, 대면 인증, 또는 아직 별도로 구축한 것이 없는 초기 단계에 적합한 선택입니다.
#자동화가 필요할 때
콘솔에 표시되는 것에서 그치지 않고 결과가 여러분의 시스템을 자동으로 업데이트해야 한다면, API나 SDK가 필요합니다.
| 하고 싶은 것 | 사용할 것 |
|---|---|
| 앱에서 사용자를 호스팅된 인증 페이지로 리디렉션 | 세션을 생성하는 API 호출 한 번, 그 후 반환된 URL로 리디렉션 |
| 웹 앱 안에 인증을 임베드 | JavaScript SDK 또는 in-context iframe |
| 네이티브 iOS, Android, Flutter, React Native 앱 안에서 인증 | 해당하는 네이티브 SDK - NFC에 필수 |
| WordPress/WooCommerce나 Shopify에 인증 추가 | WordPress/WooCommerce 또는 Shopify 플러그인 - 코드 불필요 |
| 자동화 도구에 연결 | Zapier, n8n, 또는 HTTP 요청을 보내고 웹훅을 받을 수 있는 모든 도구에서 API 사용 |
| 결과가 준비되는 즉시 백엔드로 전달받기 | 웹훅 |
| 개별 검사를 직접 실행(배치 처리, 커스텀 캡처 UI) | 워크플로우 세션이 아니라 독립형 API를 직접 호출 |
#직접 링크 보내기
API로 세션을 생성하면 Didit이 인증 URL을 반환하며, 그 이후 전달은 여러분의 몫입니다. 자체 브랜딩과 문구로 자체 제품에서 보내는 편이 보통 더 나은 경험입니다. 사용자는 이미 여러분을 신뢰하고 있고, 낯선 발신자의 메시지는 전환에 있어 비용이기 때문입니다.
Didit이 대신 그 사람에게 이메일을 보내야 한다면, 세션 생성 시 연락처 정보를 함께 전달하세요. 여러분의 설정에서 무엇이 지원되는지는 가정하지 말고 확인하고, 이메일 언어는 플로우 언어와 별도의 필드라는 점에 유의하세요. 인증 언어 설정하기를 참고하세요.
#호스팅형, 임베드형, 네이티브형 중 선택하기
| 호스팅 리디렉션 | 임베드(웹 SDK / iframe) | 네이티브 SDK | |
|---|---|---|---|
| 필요한 코드량 | 최소 | 중간 | 가장 많음 |
| 사용자가 앱을 떠남 | 예 | 아니오 | 아니오 |
| NFC 칩 읽기 | 아니오 | 아니오 | 예 |
| 최상의 카메라 동작 | 좋음 | 좋음 | 최상 |
| 커스텀 도메인으로 URL에서 Didit 제거 | 예 | 해당 없음 | 해당 없음 |
NFC가 중요하다면 이 행이 결정합니다. 칩은 브라우저 페이지에서 읽을 수 없습니다. NFC 칩 인증을 참고하세요.
임베드 옵션 중 어떤 것이 여러분의 플랜에서 이용 가능한지는 프로젝트 범위를 정하기 전에 Didit 담당자에게 확인해 볼 가치가 있습니다.
#독립형 API 대 워크플로우 세션
워크플로우 세션은 여러 검사를 함께 실행해 하나의 종합 결정을 만들어내며, 4개 무료 티어 기능에 대한 기능별 무료 한도를 사용합니다. 독립형 API 호출은 제공한 데이터에 대해 검사 하나만 실행해 해당 결과만 반환하며, 무료 한도 없이 호출 단위로 과금됩니다.
독립형 호출은 배치 처리, 직접 만든 캡처 UI, 또는 온보딩 플로우 밖에서 실행하고 싶은 검사에 적합한 도구입니다. 무료 티어를 노리고 있었다면 잘못된 선택입니다.
#실제 서비스 전 테스트하기
테스트용으로 샌드박스 모드로 별도의 애플리케이션을 만드세요 - 각 애플리케이션은 자체 API 키와 워크플로우를 가지므로 테스트 트래픽이 실제 데이터에 영향을 주지 않고, 샌드박스 세션은 비용이 들지 않으면서 원하는 결과를 강제할 수 있습니다. 샌드박스에서 테스트하기를 참고하세요.
#다음 단계
- 아직 워크플로우를 만들지 않았다면 먼저 설정하세요: 인증 워크플로우 만들기
- 결과가 준비되는 즉시 받기: 웹훅으로 인증 결과 받기
- API 키 찾는 방법: API 키 관리하기
- 오류가 반환될 때: API 오류와 그 의미