Geliştiriciler

İmzayı ürününüzün içine koyun.

REST API anahtarları, iş olaylarında webhook/callback, SFTP entegrasyonu ve Docker ile kendi altyapınıza kurulum. İmza akışını kendi sisteminizden yönetin.

TEMEL URLhttps://imzayeri.com/api/rest
KİMLİKaccess_token başlığında JWT; kullanıcı / organizasyon API anahtarı
BİÇİMJSON istek ve yanıtlar; PDF yükleme için multipart
SÜRÜMAgreement Server API 4.1
Akış

Altı çağrıda imzalı belge.

  1. İş oluşturun

    POST /jobs — imza akışının kapsayıcısı. Tip: karşı taraf imzalar (ME_OTHERS) ya da kendiniz (SELF).

    POST /jobs
  2. Belgeyi yükleyin

    PDF'i işe ekleyin; birden çok PDF birleştirilebilir, ekler gömülebilir.

    POST /jobs/{id}/documents
  3. Alıcıları ve alanları tanımlayın

    İsim, e-posta, imza yöntemi; sıralı ya da paralel akış; imza alanları ve form alanları.

    POST /jobs/{id}/recipients
  4. Akışı başlatın

    Tasarımı bitirin; alıcılar bildirim alır ve kendi yöntemleriyle imzalar. Hesap gerekmez.

    PUT /jobs/{id}/finish
  5. Olayları dinleyin

    Webhook/callback ile job.completed ve ara durumlar sisteminize düşer; SFTP ile otomatik teslim.

    callbacks · sftp
  6. İmzalı belgeyi alın

    PAdES-LTA formatında, zaman damgası ve sertifika zinciri gömülü; çevrimdışı doğrulanır.

    GET /jobs/{id}/documents
Örnek

İlk isteğiniz.

API anahtarınızı uygulama panelinden oluşturun, ardından bir iş açın. Tam istek/yanıt şemaları ve durum geçişleri iş akışı kılavuzunda.

Adlandırılmış / süreli / iptal edilebilir API anahtarları · olay bazlı webhook · SFTP · Docker dağıtım.

# imza işi oluştur
curl -X POST https://api.imzayeri.com/v1/jobs \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document": "…", "recipients": [{ "email": "…", "method": "mobil_imza" }] }'
// webhook · job.completed
{ "event": "job.completed", "job_id": "…",
  "signed_at": "2026-07-07T14:22:31+03:00", "verification": "LTA" }
Yetenekler

API ile yapabilecekleriniz.

İşler ve belgeler

Job yaşam döngüsü (NONE → DRAFT → IN_PROGRESS → COMPLETED), PDF yükleme, birleştirme, şablonlar.

Alıcılar

Sıralı / paralel / gruplu akış, alıcı rolleri, kabul-ret, istek kodu ile hesapsız imza.

Ek dosyalar

PDF içine gömülü ekler (iş başına 50'ye kadar), sıralanabilir, ZIP indirme.

Form alanları

İmza, metin, onay kutusu ve ek dosya listesi alanları; koordinat ya da çapa ile yerleşim.

Webhook / callback

İş ve imza olaylarında HTTP çağrısı; polling uç noktaları.

SFTP teslim

Tamamlanan belgelerin kendi sunucunuza otomatik aktarımı.

Ekip ve şablonlar

Organizasyon üyeleri, kurumsal şablonlar, adres defteri, etiketler.

Denetim izi

Belge ve imza denetim kayıtları; imza doğrulama raporları.

KEP ve e-Yazışma (EYP)

Kamu kurumları için EYP paketleme, DETSİS, KEP gönderimi.

Tam referans

OpenAPI referansı ve SDK, anlaşma sonrasında.

Etkileşimli API referansı (tüm uç noktalar, şemalar, hata kodları), PHP istemci kütüphanesi ve örnek projeler entegrasyon anlaşmasıyla birlikte paylaşılır. Teknik görüşmede ihtiyacınızı dinler, test hesabı ve dokümantasyon erişimi açarız.