QuickSign

İmza şablonları

Şablon, bir imzacı için üretilecek imza metnini ve bu metnin sayfadaki konumunu tanımlar. Metindeki yer tutucular imza anında sertifikadaki bilgiler ve imza zamanıyla doldurulur.

Şablon bir token kaydına bağlanabilir (templateId) veya imza isteğinde imzacı başına seçilebilir. İşlenmiş metin ve konum imza yanıtındaki SignerDetails alanında döner.

Yer tutucular

Yer tutucuDeğerÖrnek
{{adSoyad}}Sertifikadaki tam adALİ YILMAZ
{{ad}}Ad (son kelime hariç)ALİ
{{soyad}}Soyad (son kelime)YILMAZ
{{tckn}}TC kimlik numarası12345678901
{{tarih}}İmza tarihi01.01.2026
{{tarihSaat}}İmza tarihi ve saati01.01.2026 14:30
{{sira}}İmzacı sırası1
{{siraYazi}}İmzacı sırası yazıylaBirinci

Konumlar

DeğerKonum
bottom-leftSol alt
bottom-centerAlt orta
bottom-rightSağ alt
top-leftSol üst
top-centerÜst orta
top-rightSağ üst
autoİmzacı sırasına göre: 1. sol alt, 2. sağ alt, 3. sol üst, 4. sağ üst, 5. ve sonrası alt orta

auto çok imzacılı belgelerde damgaların üst üste binmesini önler.

Hazır şablonlar

QuickSign ilk açılışta sekiz sistem şablonu ekler. Sistem şablonları değiştirilemez ve silinemez; bunları örnek alıp kendi şablonunuzu oluşturabilirsiniz.

AdKonumMetin
sol-altsol altBu belge {{tarih}} tarihinde / {{adSoyad}} tarafından / imzalanmıştır.
sag-altsağ alt(aynı metin)
sol-ustsol üst(aynı metin)
sag-ustsağ üst(aynı metin)
standartauto{{sira}}. İmzacı: {{adSoyad}} / TCKN: {{tckn}} / İmza Tarihi: {{tarih}}
resmialt ortaONAYLAYAN / {{adSoyad}} / T.C. Kimlik No: {{tckn}} / {{tarihSaat}}
kisaauto{{adSoyad}} tarafından imzalanmıştır. ({{tarih}})
tek-satirautoBu belge {{siraYazi}} imzacı {{adSoyad}} (TCKN: {{tckn}}) tarafından {{tarih}} tarihinde imzalanmıştır.

Tablodaki / satır sonunu gösterir; şablon metninde satır sonu \n ile yazılır.

Şablonları yönetme

bash
# listele — her şablon örnek verilerle işlenmiş "Preview" alanıyla döner
curl http://localhost:5000/api/sign/templates

# oluştur
curl -X POST http://localhost:5000/api/sign/templates \
  -H "Content-Type: application/json" \
  -d '{"name":"onay","text":"Onaylayan: {{adSoyad}}\n{{tarihSaat}}","position":"bottom-right"}'

# güncelle (yalnız gönderilen alanlar değişir)
curl -X PUT http://localhost:5000/api/sign/templates/9 \
  -H "Content-Type: application/json" -d '{"position":"auto"}'

# sil
curl -X DELETE http://localhost:5000/api/sign/templates/9

Şablonu kullanma

Token'a varsayılan şablon atamak:

bash
curl -X PATCH http://localhost:5000/api/sign/tokens/1 \
  -H "Content-Type: application/json" -d '{"templateId":9}'

İstek başına şablon seçmek veya şablonu kapatmak (/api/sign/sync ve /api/sign/async):

json
{
  "data": "<BASE64>",
  "signers": [
    { "alias": "muhasebe", "templateId": 6 },
    { "tckn": "09876543210", "pin": "5678", "templateId": 0 }
  ]
}

templateId verilmezse token'a atanmış şablon, 0 verilirse hiçbir şablon kullanılmaz.

Sorunuzun cevabını bulamadınız mı? [email protected]