İmzalama akışı (Developer API)
Belgeyi oluşturup gönderdikten sonra imzacı deneyimi ve entegrasyon notları.
Önkoşul: Tek istekte belge gönderme, Belge gönderme akışı veya Şablon gönderme akışı.
Body şemaları: Geliştirici belgeleri.
Public imza linki
| Kaynak | Alan | Kullanım |
|---|---|---|
| Liste / detay | publicShortCode | Gönderim sonrası takip; bazı senaryolarda kısa link |
| Send yanıtı | initialRecipientAccessCode | open_on_device veya ilk alıcı yönlendirmesi |
Uygulama (web) base URL ile:
{appBase}/r/{code}
Örnek: https://dijital-imza.com/r/ABC12XYZ
useUniqueDeliveryKey: true iken e-posta/SMS linkleri alıcıya özel tahmin edilemez kod kullanır; detaydaki publicShortCode her zaman her alıcının linki değildir.
İmza alanı türleri
Configuration elements[].elementType:
| Tür | Açıklama |
|---|---|
SIGNATURE | Klasik çizim imza |
BIOMETRIC_SIGNATURE | Biyometrik imza; config.biometricSignatureType: basic veya forensic |
ELECTRONIC_SIGNATURE | Masaüstü e-imza istemcisi; public akışta hazırlık → /app/{code} |
Örnek body’ler API referansında.
Sıralı ve paralel akış
isOrderedFlow | Davranış |
|---|---|
true | Alıcılar order sırasıyla; bir önceki tamamlanmadan sonraki bildirim/adım ilerlemez |
false | Alıcılar paralel ilerleyebilir |
Configuration ve send’te aynı bayrağı tutarlı gönderin.
Alıcı rolleri
role | Tipik kullanım |
|---|---|
Signee | İmza / zorunlu alan doldurma |
Approver | Onay odaklı alıcı |
Viewer | Görüntüleme / bilgilendirme |
Alanlar recipientExternalId ile alıcıya atanır. İmza alanını imzacıya verin.
Doğrulama politikası
recipients[].recipientProfile.verification ile imza öncesi OTP açılır:
phoneOtpVerification— e-posta ve/veya telefona OTP (alıcıda ilgili iletişim alanı dolu olmalı)
Detaylı alan tablosu: Geliştirici belgeleri.
Elektronik imza
ELECTRONIC_SIGNATURE alanı varsa imzacı aşağıdaki adımları izler:
1. Public ekran
İmzacı /r/{code} public ekranda elektronik imza adımını görür.
2. İstemci
Masaüstü istemciyi indirir veya /app/{code} sayfasını kullanır.
3. Tamamlama
İstemci üzerinden imzalı PDF’i göndererek akışı tamamlar.
Kurulum: /help/elektronik-imza.
Tamamlanan belge / çıktı
| Çıktı | Nasıl |
|---|---|
| Final PDF | GET /developer/documents/{operationId}/final-pdf veya web {appBase}/d/{code} |
| Sertifika PDF | GET /developer/documents/{operationId}/certificate-pdf |
| Zaman damgası | GET /developer/documents/{operationId}/timestamp-file |
Durum değerleri: Durum takibi.
Detay yanıt sınırı
GET /developer/documents/{operationId} işlem status, publicShortCode ve recipients[] (deliveryStatus, isStepCompleted) döner. Webhook yoktur — polling kullanın.