# 연동 방법: API, SDK, 노코드 링크

Source: https://help.didit.me/ko/integration/integration-options
Updated: 2026-10-12

코드를 작성하지 않아도 Didit으로 신원 확인을 시작할 수 있습니다 - 노코드 링크를 사용하거나, 자동화가 필요할 때 SDK나 API를 도입하세요.

세 가지 경로가 있습니다. **노코드 링크**는 백엔드가 전혀 필요 없습니다. **API와 리디렉션**의 조합은 표준적인 연동 방식입니다. **SDK**는 플로우를 여러분의 앱 안에 넣는 방식이며, NFC를 지원하는 유일한 경로입니다. 어떤 방식을 선택하든 [웹훅](https://help.didit.me/ko/integration/webhooks-basics)으로 결과를 받으세요.

[Video: 전체 연동 가이드 - Didit Academy](https://www.youtube.com/watch?v=fX03-WEu_EI)

[Video: KYC 연동 옵션: 리디렉션 링크 vs iFrame vs 네이티브 SDK - Didit Academy](https://www.youtube.com/watch?v=MxMFf43KONg)

Didit으로 신원 확인을 시작하는 데 개발자가 꼭 필요하지는 않습니다. 몇 분이면 끝나는 노코드 옵션이 있고, 자체 제품 안에서 자동화하고 싶을 때를 위한 API와 SDK 옵션도 있습니다.

## 코딩 없이 Didit을 사용할 수 있나요?

가능합니다. 콘솔에서 [워크플로우를 구성](https://help.didit.me/ko/workflows/build-a-verification-workflow)했다면, 코드 없이 두 가지 방법으로 인증 세션을 생성할 수 있습니다.

![API 키 발급부터 첫 세션까지 5단계 체크리스트로 구성된 Didit 콘솔의 Integrate 페이지](https://help.didit.me/screenshots/integrate-light.webp)

*Integrate 페이지는 아무것도 없는 상태에서 작동하는 세션까지 가는 가장 짧은 경로입니다.*

1. **인증 링크(일회성)**

   **새 인증**(홈, 인증 목록, 개인 프로필에 있음)을 누르고, **워크플로**를 선택하고, **벤더
   데이터**에 해당 대상에 대한 자체 ID를 입력한 뒤 **인증 생성**을 누르세요. 그런 다음 링크를
   이메일로 보내거나, 복사하거나, QR 코드를 보여 주면 됩니다. **단일 검사** 탭에서는 워크플로우
   전체 없이 AML 스크리닝 같은 검사 하나만 실행합니다.

2. **재사용 가능한 링크(Unilink)**

   각 워크플로우에는 방문할 때마다 새 세션을 시작하는 재사용 가능한 링크도 하나씩 있습니다. 사이트의 버튼 뒤에 넣거나, 키오스크나 지점용 QR 코드로 인쇄하거나, 제휴사와 공유하세요. [재사용 가능한 링크](https://help.didit.me/ko/integration/reusable-links)를 참고하세요.

두 방법 모두 API와 백엔드를 완전히 건너뜁니다 - MVP, 수동 검토, 대면 인증, 또는 아직 별도로 구축한 것이 없는 초기 단계에 적합한 선택입니다.

## 자동화가 필요할 때

[Video: MCP로 Didit을 Claude에 연결하기 - Didit Academy](https://www.youtube.com/watch?v=I3UkFIhW548&t=71)

콘솔에 표시되는 것에서 그치지 않고 결과가 여러분의 시스템을 자동으로 업데이트해야 한다면, API나 SDK가 필요합니다.

| 하고 싶은 것 | 사용할 것 |
|---|---|
| 앱에서 사용자를 호스팅된 인증 페이지로 리디렉션 | 세션을 생성하는 API 호출 한 번, 그 후 반환된 URL로 리디렉션 |
| 웹 앱 안에 인증을 임베드 | [JavaScript SDK](https://docs.didit.me/integration/web-sdks/javascript-sdk) 또는 [in-context iframe](https://docs.didit.me/integration/web-sdks/incontext-iframe) |
| 네이티브 iOS, Android, Flutter, React Native 앱 안에서 인증 | 해당하는 [네이티브 SDK](https://help.didit.me/ko/integration/mobile-sdks) - NFC에 필수 |
| WordPress/WooCommerce나 Shopify에 인증 추가 | [WordPress/WooCommerce](https://docs.didit.me/integration/web-sdks/wordpress-woocommerce) 또는 [Shopify](https://docs.didit.me/integration/web-sdks/shopify) 플러그인 - 코드 불필요 |
| 자동화 도구에 연결 | [Zapier](https://docs.didit.me/integration/engines/zapier), n8n, 또는 HTTP 요청을 보내고 웹훅을 받을 수 있는 모든 도구에서 API 사용 |
| 결과가 준비되는 즉시 백엔드로 전달받기 | [웹훅](https://help.didit.me/ko/integration/webhooks-basics) |
| 개별 검사를 직접 실행(배치 처리, 커스텀 캡처 UI) | 워크플로우 세션이 아니라 독립형 API를 직접 호출 |

## 직접 링크 보내기

API로 세션을 생성하면 Didit이 인증 URL을 반환하며, 그 이후 전달은 여러분의 몫입니다. 자체 브랜딩과 문구로 자체 제품에서 보내는 편이 보통 더 나은 경험입니다. 사용자는 이미 여러분을 신뢰하고 있고, 낯선 발신자의 메시지는 전환에 있어 비용이기 때문입니다.

Didit이 대신 그 사람에게 이메일을 보내야 한다면, 세션 생성 시 연락처 정보를 함께 전달하세요. 여러분의 설정에서 무엇이 지원되는지는 가정하지 말고 확인하고, **이메일 언어는 플로우 언어와 별도의 필드**라는 점에 유의하세요. [인증 언어 설정하기](https://help.didit.me/ko/workflows/verification-languages)를 참고하세요.

## 호스팅형, 임베드형, 네이티브형 중 선택하기

| | 호스팅 리디렉션 | 임베드(웹 SDK / iframe) | 네이티브 SDK |
|---|---|---|---|
| 필요한 코드량 | 최소 | 중간 | 가장 많음 |
| 사용자가 앱을 떠남 | 예 | 아니오 | 아니오 |
| NFC 칩 읽기 | 아니오 | 아니오 | **예** |
| 최상의 카메라 동작 | 좋음 | 좋음 | 최상 |
| 커스텀 도메인으로 URL에서 Didit 제거 | 예 | 해당 없음 | 해당 없음 |

NFC가 중요하다면 이 행이 결정합니다. 칩은 브라우저 페이지에서 읽을 수 없습니다. [NFC 칩 인증](https://help.didit.me/ko/documents-coverage/nfc-chip-verification)을 참고하세요.

임베드 옵션 중 어떤 것이 여러분의 플랜에서 이용 가능한지는 프로젝트 범위를 정하기 전에 Didit 담당자에게 확인해 볼 가치가 있습니다.

## 독립형 API 대 워크플로우 세션

워크플로우 세션은 여러 검사를 함께 실행해 하나의 종합 결정을 만들어내며, 완료된 기능별로 과금됩니다. 독립형 API 호출은 제공한 데이터에 대해 검사 하나만 실행해 해당 결과만 반환하며, 해당 검사의 정가로 **호출 단위로 과금**됩니다.

독립형 호출은 배치 처리, 직접 만든 캡처 UI, 또는 온보딩 플로우 밖에서 실행하고 싶은 검사에 적합한 도구입니다. 전체 플로우에 대해 하나의 종합 결정을 원했다면 잘못된 선택입니다.

## 실제 서비스 전 테스트하기

애플리케이션 이름 아래 스위치에서 **Sandbox**를 선택하고 테스트 API 키를 만들어 사용하세요. 검사는 모의 처리되고 요금이 없으며 원하는 결과를 지정할 수 있습니다.

[샌드박스에서 테스트하기](https://help.didit.me/ko/getting-started/sandbox-and-testing)

## 다음 단계

- 아직 워크플로우를 만들지 않았다면 먼저 설정하세요: [인증 워크플로우 만들기](https://help.didit.me/ko/workflows/build-a-verification-workflow)
- 결과가 준비되는 즉시 받기: [웹훅으로 인증 결과 받기](https://help.didit.me/ko/integration/webhooks-basics)
- API 키 찾는 방법: [API 키 관리하기](https://help.didit.me/ko/account-organization/api-keys)
- 오류가 반환될 때: [API 오류와 그 의미](https://help.didit.me/ko/integration/api-errors)

## AI 도구 연결

**AI 도구 연결**에서 도구를 선택하고 설정 안내를 따르세요. 연결을 승인할 때 대상 조직을 선택하고 요청된 권한을 확인하세요. 계정이나 조직이 잘못되었다면 접근을 허용하기 전에 전환하세요.