서명을 위해 문서를 보내는 방법

이 문서에서는 Sign.Plus eSignature API를 사용하여 서명을 위해 문서를 보내는 과정을 안내합니다.

이 단계들을 따라 봉투(envelope)를 만들고, 문서를 추가하고, 수신자를 설정하고, 서명 어노테이션을 삽입한 다음, 마지막으로 서명을 위해 봉투를 전송합니다.

사전 요건

• API 요금제가 있는 Sign.Plus 계정
• 사용자의 Personal Access Token

1단계: 봉투 만들기

봉투(envelope)는 수신자가 서명할 문서를 담는 컨테이너입니다.

1. 새 봉투를 생성하려면 POST /v2/envelope 엔드포인트로 요청을 보내세요. {
"name": "My wonderful envelope",
"flow_type": "REQUEST_SIGNATURE",
"legality_level": "SES",
"expires_at": 1831280113,
"sandbox": true
}
2. Authorization 헤더에 API 키를 포함하세요.

3. 성공하면 Envelope 객체를 받게 됩니다.

   { "id": "<string>" ... }

4. id를 envelope_id로 저장하세요.

2단계: 봉투에 문서 추가하기

1. 문서를 추가하려면 POST /v2/envelope/{envelope_id}/document 엔드포인트를 사용하세요.

2. 1단계에서 받은 ID로 {envelope_id}를 교체하세요.

3. 요청 본문에 문서 파일을 multipart/form-data.로 포함하여 POST 요청을 보내세요.

4. 성공하면 응답으로 Document 객체를 받게 됩니다.
   { "id": "<string>" ... }

5. 이후 사용을 위해 id를 document_id로 저장하세요.

3단계: 봉투에 수신자 설정하기

1. POST /v2/envelope/{envelope_id}/signing_steps 엔드포인트를 사용하여 수신자를 추가하세요.

2. {envelope_id}를 사용자의 봉투 ID로 바꾸세요.

3. 다음 JSON 본문과 함께 POST 요청을 보내세요:

   {
"signing_steps": [
{
"recipients": [
{
"name": "John Doe", "email": "john.doe@example.com", "role": "SIGNER"
} ] } ] }

4. 성공하면 SigninStep 배열을 받게 됩니다.

5. 배열을 살펴보고 서명 프레임(서명 어노테이션)을 추가하려는 수신자의 id 이름을 확인하세요. 이 id를 recipient_id로 저장하세요.

4단계: 문서에 서명 어노테이션 삽입하기

서명 어노테이션을 추가하기 전에, Sign.Plus 플랫폼에서 서명을 정의했는지 확인하세요.

1. POST /v2/envelope/{envelope_id}/annotation 엔드포인트를 사용하여 서명 어노테이션을 추가하세요.
2. {envelope_id}를 사용자의 봉투 ID로 바꾸세요. 
3. 다음 JSON 본문으로 POST 요청을 보내세요:
   {
"recipient_id": "<recipient_id>",
"document_id": "<document_id>",
"page": 1,
"x": 50,
"y": 20,
"width": 20,
"height": 60,
"required": true,
"type": "SIGNATURE",
}

   <recipient_id>와 <document_id>를 적절한 값으로 바꾸세요.

5단계: 서명을 위해 봉투 보내기

1. POST /v2/envelope/{envelope_id}/send 엔드포인트를 사용하여 봉투를 보내세요.
2. {envelope_id}를 사용자의 봉투 ID로 바꾸세요.
3. 이 엔드포인트로 POST 요청을 보내세요.
4. 성공하면 봉투가 서명을 위해 수신자에게 전송됩니다.
   
   

결론

이제 Sign.Plus eSignature API를 사용하여 서명을 위해 문서를 성공적으로 전송했습니다. 수신자는 문서에 서명할 수 있는 링크가 포함된 이메일 알림을 받게 됩니다.

이 과정에서 사용되는 각 API 엔드포인트에 대한 자세한 정보는 API 문서를 참조하세요.