DocsReferencesChangelogCommunity
Changelog
Start typing to search…
Back to All
Added

1.39.0

about 2 months ago

"간편인증(통합인증) 기능 추가"

서명 요청 및 임베디드 초안 생성 시 다양한 모바일 인증 수단을 선택적으로 제공할 수 있는 기능이 추가되었습니다.

📘

새로운 파라미터 추가: verification.mobileIdentification.allowOptions

이 파라미터를 통해 서명자에게 제공할 인증 수단을 직접 제어할 수 있습니다. 기존 API 요청은 수정 없이 계속 사용 가능하며, allowOptions를 별도로 설정하지 않으면 자동으로 ["SMS_OR_PASS"]가 기본값으로 적용됩니다.

주요 변경사항

기존에는 인증 수단이 고정되어 있었으나, 이제 allowOptions 파라미터를 통해 제공할 인증 방식을 선택할 수 있습니다.

요청 형식

{
  "verification": {
    "mobileIdentification": {
      "name": "김모두",
      "phoneNumber": "01012345678",
      "allowOptions": ["SIMPLE_AUTH", "SMS_OR_PASS"]
    }
  }
}

파라미터 상세

verification.mobileIdentification

필드타입필수 여부설명
nameString필수서명자의 실명
phoneNumberString필수서명자의 휴대폰 번호 (하이픈 없이 입력)
allowOptionsArray선택[신규] 제공할 인증 수단 목록
미설정 시 ["SMS_OR_PASS"] 기본값 적용

allowOptions 설정 값

"allowOptions": ["SIMPLE_AUTH"]

제공되는 인증 수단:

  • 카카오톡 인증
  • 네이버 인증
  • 토스 인증
  • 금융권 인증
  • 기타 간편인증 서비스

적용 가능한 API

이 기능은 다음 엔드포인트에서 사용할 수 있습니다:

API엔드포인트비고
서명 요청POST /documents새로운 서명 요청 문서 생성
템플릿으로 서명 요청POST /documents/request-with-template템플릿 기반 서명 요청
임베디드 초안 생성POST /embedded-drafts임베디드 환경 초안 생성
템플릿으로 임베디드 초안 생성POST /embedded-drafts/create-with-template템플릿 기반 임베디드 초안
템플릿 생성POST /templates재사용 가능한 표준서식(템플릿) 생성