E-imzayı kendi uygulamanıza ekleyin

Başlarken

1. 1

   Geliştirici konsolunda entegratör kaydı açın

   Portala giriş yapıp Geliştirici bölümünden kendi entegratör kaydınızı oluşturursunuz. Kayıt açıldığında bir API anahtarı üretilir; anahtar yalnızca bir kez gösterilir, kaybederseniz konsoldan yeniden üretebilirsiniz.
2. 2

   İzin listelerinizi tanımlayın

   Kullanıcının imza sonrası döneceği adresler ve — kullanacaksanız — webhook adresiniz alan adı bazında izin listesine girer. Listede olmayan bir adrese yönlendirme yapılmaz; bu, oturumunuzun başka bir siteye taşınmasını engeller.
3. 3

   Zaman damgası hesabınızı girin

   Zaman damgalı ve uzun dönemli profiller için RFC 3161 sunucu adresiniz ve kimlik bilgileriniz konsoldan tanımlanır. Damga sizin kontörünüzden düşer; parola şifreli saklanır ve bir daha okunamaz.
4. 4

   İsteklerinizi API anahtarıyla imzalayın

   Sunucudan sunucuya yapılan tüm çağrılarda anahtarı başlıkta gönderirsiniz:X-WSign-Api-Key: <api-anahtarınız>Anahtar yalnızca sunucu tarafında durmalıdır — tarayıcıya koymayın.

Kullanıcıya imza attırmanın en kısa yolu. Belgeyi ve dönüş adreslerinizi gönderir, karşılığında bir imza bağlantısı alırsınız; kullanıcıyı oraya yönlendirirsiniz. İmza tamamlandığında kullanıcı sizin adresinize döner ve sonucu üç yoldan biriyle alırsınız.

1. Oturumu açın

POST https://api.sign.wsoft.tr/v1/redirect-sign/sessions
X-WSign-Api-Key: <api-anahtarınız>
Content-Type: application/json

{
  "documentBase64":     "<belge içeriği, base64>",
  "documentName":       "Sozlesme.pdf",
  "successRedirectUrl": "https://uygulamaniz.com/imza/tamam",
  "cancelRedirectUrl":  "https://uygulamaniz.com/imza/iptal",
  "nonce":              "<base64, en az 16 bayt rastgele>",
  "signatureProfile":   "CAdES-T",
  "ttlMinutes":         15
}

201 Created yanıtında sessionId, kullanıcıyı göndereceğiniz redirectUrl, expiresAt ve zaman damgası uygulanıp uygulanmayacağını belirten timestamped döner.

2. Kullanıcıyı yönlendirin

Kullanıcı imza sayfasında belgeyi görür, kartını takar ve PIN'ini girer. İmza kartın üzerinde üretilir; özel anahtar hiçbir aşamada cihazdan çıkmaz. Ardından belirttiğiniz adrese döner.

3. Sonucu alın — üç yol

Üç yolun da taşıdığı yük aynıdır ve aynı HMAC ile imzalanır — birinden diğerine geçmek için doğrulama kodunuzu değiştirmeniz gerekmez. Gönderdiğiniz nonce yükte geri döner; oturumu kendi kaydınızla eşleştirmek için kullanın.

Kendi arayüzünüzü koruyarak imzalamak istediğinizde. İki adımlıdır: sunucu imzalanacak veriyi hazırlar, kartın ürettiği ham imzayı geri gönderirsiniz, imzalı yapıyı sunucu tamamlar. Belge kullanıcının bilgisayarına inmez, imza mantığı sizde değil bizde kalır.

Adım 1 — hazırla

POST https://api.sign.wsoft.tr/v1/sign/hash/prepare
X-WSign-Api-Key: <api-anahtarınız>
Content-Type: application/json

{
  "algorithm":       "CAdES-T",
  "content":         "<belge içeriği, base64>",
  "certificateId":   "<imzalayanın sertifikası>",
  "digestAlgorithm": "SHA-256"
}

Yanıt: sessionId, karta imzalatacağınız dataToSign (base64) ve oturumun geçerlilik süresi.

Adım 2 — tamamla

Kartın ürettiği ham imzayı sessionId ile birlikte /v1/sign/hash/complete ucuna gönderirsiniz. Yanıtta imzalı yapı ve imzalayan sertifika döner; zaman damgası, zincir ve iptal verisi seçtiğiniz profile göre içine yerleştirilmiş olur.

Profiller

PDF yüklediğinizde portal akışı imzayı PDF'in içine gömer (PAdES) ve uzun dönemli seviyede üretir; imza, standart PDF görüntüleyicilerin imza panelinde görünür.

Doğrulama ucu API anahtarı istemez. İmzalı PDF, CAdES (.p7s, .cms, .p7m) veya XAdES (.xml) dosyasını gönderirsiniz; imzanın geçerliliği, imzalayan sertifika, zaman damgası ve uzun dönem doğrulama bilgileri döner. Belgede birden fazla imza varsa hepsi listelenir.

POST https://api.sign.wsoft.tr/v1/verify/upload
Content-Type: multipart/form-data

file=@sozlesme.pdf
# ayrık imzada orijinal dosyayı da ekleyin:
# detached=@sozlesme.pdf.p7s

Aynı işi tarayıcıdan denemek için imza doğrulayıcıyı kullanabilirsiniz — kurulum ve hesap gerekmez.

Limitler ve hata kodları