Belge imzaya nasıl gönderilir?

Bu makale, Sign.Plus e-İmza API'sini kullanarak bir belgeyi imzaya gönderme sürecinde size adım adım rehberlik edecektir.

Bu adımları izleyerek bir zarf oluşturacak, bir belge ekleyecek, bir alıcı belirleyecek, bir imza ek açıklaması ekleyecek ve son olarak zarfı imzaya göndereceksiniz.

Ön Koşullar

• API Planı bulunan bir Sign.Plus hesabı
• Kişisel Erişim Belirteciniz: Personal Access Token

1. Adım: Zarf oluşturun

Zarf, alıcılar tarafından imzalanacak belgeler için bir kapsayıcıdır.

1. Yeni bir zarf oluşturmak için POST /v2/envelope uç noktasına bir istek gönderin. {
"name": "My wonderful envelope",
"flow_type": "REQUEST_SIGNATURE",
"legality_level": "SES",
"expires_at": 1831280113,
"sandbox": true
}
2. API anahtarınızı Authorization başlığına ekleyin.

3. İşlem başarılı olduğunda bir Envelope nesnesi alırsınız.

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

4. id değerini envelope_id olarak kaydedin.

2. Adım: Zarfınıza belge ekleyin

1. Belge eklemek için POST /v2/envelope/{envelope_id}/document uç noktasını kullanın.

2. {envelope_id} değerini 1. Adım'da aldığınız kimlikle değiştirin.

3. Belge dosyasını istek gövdesinde multipart/form-data. olarak içeren bir POST isteği gönderin.

4. İşlem başarılı olursa yanıt olarak bir Document nesnesi alırsınız.
   { "id": "<string>" ... }

5. id değerini daha sonra kullanmak üzere document_id olarak kaydedin.

3. Adım: Zarfınız için bir alıcı belirleyin

1. Bir alıcı eklemek için POST /v2/envelope/{envelope_id}/signing_steps uç noktasını kullanın.

2. {envelope_id} ifadesini kendi zarf kimliğinizle değiştirin.

3. Aşağıdaki JSON gövdesiyle bir POST isteği gönderin:

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

4. İşlem başarılı olursa bir SigninStep dizisi alırsınız.

5. Diziyi inceleyin ve imza çerçevesini (imza ek açıklaması) eklemek istediğiniz alıcının id adını alın. Bu id değerini recipient_id olarak kaydedin.

4. Adım: Belgenize imza ek açıklaması ekleyin

İmza ek açıklaması eklemeden önce imzanızı Sign.Plus platformunda tanımladığınızdan emin olun.

1. İmza ek açıklaması eklemek için POST /v2/envelope/{envelope_id}/annotation uç noktasını kullanın.
2. {envelope_id} yerine zarf kimliğinizi yazın. 
3. Aşağıdaki JSON gövdesiyle bir POST isteği gönderin:
   {
"recipient_id": "<recipient_id>",
"document_id": "<document_id>",
"page": 1,
"x": 50,
"y": 20,
"width": 20,
"height": 60,
"required": true,
"type": "SIGNATURE",
}

   <recipient_id> ve <document_id> yerine uygun değerleri yazın.

5. Adım: Zarfınızı imza için gönderin

1. Zarfı göndermek için POST /v2/envelope/{envelope_id}/send uç noktasını kullanın.
2. {envelope_id} yerine zarf kimliğinizi yazın.
3. Bu uç noktaya bir POST isteği gönderin.
4. İşlem başarılı olursa zarf, imzalanmak üzere alıcıya gönderilir.
   
   

Sonuç

Sign.Plus e-İmza API'sini kullanarak bir belgeyi imzaya başarıyla gönderdiniz. Alıcı, belgeyi imzalayabilmesi için bir bağlantı içeren bir e-posta bildirimi alacaktır.

Bu süreçte kullanılan her bir API uç noktası hakkında daha ayrıntılı bilgi için lütfen API belgelerimize göz atın.