Bu makale, Sign.Plus e-İmza API'si ile bir şablon kullanarak imzalanmak üzere belge gönderme sürecinde size rehberlik edecektir.
Bu adımları izleyerek bir şablondan zarf oluşturacak, alıcı ayrıntılarını belirleyecek ve zarfı imzalanmak üzere göndereceksiniz.
Ön Koşullar
- API Planı bulunan bir Sign.Plus hesabı
-
Personal Access Tokendeğeriniz - Sign.Plus hesabınızda mevcut bir şablon
1. Adım: Şablondan zarf oluşturun
- Bir şablondan yeni bir zarf oluşturmak için POST /v2/envelope/from_template/{template_id} uç noktasını kullanın.
-
{template_id}ifadesini mevcut şablonunuzun kimliğiyle değiştirin.
Şablon kimliğini nerede bulabilirim?-
https://app.sign.plus/templates adresine gidin.
- İstediğiniz şablonun adına tıklayın.
- Kimliği sağ kenar çubuğundan kopyalayın.
-
https://app.sign.plus/templates adresine gidin.
- Aşağıdaki JSON gövdesiyle
POST /v2/envelope/from_template/{template_id}adresine bir POST isteği gönderin:{"name": "My wonderful envelope from template"} - API anahtarınızı
Authorizationüstbilgisine ekleyin. - İşlem başarılı olursa bir
Envelopenesnesi alırsınız.{"id": "66eb7d0467d2d549b89fcb6d",// ..."signing_steps": [{"recipients": [{"id": "66eb7d0467d2d549b89fcb70","uid": null,"name": "","email": "","role": "SIGNER","verification": null}]},{"recipients": [{"id": "66eb7d0467d2d549b89fcb71","uid": null,"name": "","email": "","role": "RECEIVES_COPY","verification": null},{"id": "66eb7d0467d2d549b89fcb72","uid": null,"name": "","email": "","role": "SIGNER","verification": null}]}],"documents": [// ...],"notification": {// ...}} - Döndürülen
iddeğerini sonraki API çağrıları içinenvelope_idolarak kaydedin. - Her alıcının
iddeğerini, imzalama sürecinde daha sonra kullanmak üzere not edin.
Örnekler:-
66eb7d0467d2d549b89fcb71: BirinciSIGNER(1. Adım) -
66eb7d0467d2d549b89fcb71:RECEIVES_A_COPY(1. Adım) -
66eb7d0467d2d549b89fcb72: İkinciSIGNER(2. Adım)
-
2. Adım: Alıcı bilgilerini belirleyin
Şablonunuzda sabit alıcılar yoksa ve alıcı bilgilerini belirlemeniz veya güncellemeniz gerekiyorsa:
- Alıcı bilgilerini güncellemek için POST /v2/envelope/{envelope_id}/signing_steps uç noktasını kullanın.
-
{envelope_id}yerine 1. Adım'da aldığınız kimliği yazın. - Aşağıdaki JSON gövdesiyle bir
POSTisteği gönderin:{
"signing_steps": [
{
"recipients": [
{
"id": "66eb7d0467d2d549b89fcb70",
"name": "John Doe",
"email": "john.doe@example.com",
"role": "SIGNER"
}
]
},
{
"recipients": [
{
"id": "66eb7d0467d2d549b89fcb71",
"name": "Mark Twain",
"email": "m.twain@example.com",
"role": "RECEIVES_COPY"
},
{
"id": "66eb7d0467d2d549b89fcb72",
"name": "Jane Smith",
"email": "j.smith@example.com",
"role": "SIGNER"
}
]
}
]
} - İşlem başarılı olursa
SigningStepnesnelerinden oluşan bir dizi alırsınız.
3. Adım: Zarfınızı imzaya gönderin
- Zarfı göndermek için POST /v2/envelope/{envelope_id}/send uç noktasını kullanın.
-
{envelope_id}yerine 1. Adım'daki zarf kimliğinizi yazın. - Bu uç noktaya bir
POSTisteği gönderin. - İşlem başarılı olursa zarf, imzalanmak üzere alıcılara gönderilir.
Sonuç
Sign.Plus e-İmza API'si ile bir şablon kullanarak bir belgeyi imzaya başarıyla gönderdiniz. Alıcılar, belgeyi imzalamaları için bir bağlantı içeren bir e-posta bildirimi alacak.
Şablon kullanmak, özellikle düzeni ve imza gereksinimleri tutarlı olan sık kullanılan belgeler için belge imzalama iş akışınızı önemli ölçüde kolaylaştırabilir.