E-İmza API

Kimlik doğrulama

API Başlangıç üyeliği onaylandıktan sonra panele bir API anahtarı tanımlanır. İsteklerde anahtarı Authorization: Bearer <api-key> başlığıyla gönderin. Anahtarı tarayıcıya gömmeyin; yalnızca sunucu tarafında tutun.

Doğrulama uç noktaları

• POST/api/validation/inspect

  CAdES, PAdES, XAdES veya UDF imzasını doğrular; sertifika ve zaman damgası özeti döner.

• POST/api/validation/inspect-eyp

  EYP paketini açar; üstveri, bütünlük, imza ve e-mühür bileşenlerini raporlar.

• POST/api/validation/udf-to-pdf

  UDF dosyasını geçici olarak PDF’e çevirir; çıktı saklanmaz.

İmzalama, kullanıcının bilgisayarındaki İmzaOnay Agent ile WebSocket üzerinden yapılır. Canlı deneme için onaylı API üyeleri playground ekranını kullanır.

Zaman damgası uç noktaları

İmza olmadan, içeriğin o tarihte var olduğunu ve değişmediğini gösteren KamuSM RFC 3161 damgası. Hak doğurmaz; ispat desteği sağlar. Tercihen dosya değil hash gönderilir. Damga kotası API anahtarına bağlıdır; kontör üyelik üzerinden yüklenir.

• POST/api/validation/timestamp

  İçerik özetine (hash) KamuSM nitelikli zaman damgası vurur. Kota üyelik API anahtarına bağlı damga kontöründen düşülür; yetersizse 402. Dosya saklanmaz.

• POST/api/validation/timestamp/verify

  RFC 3161 token’ını doğrular; hash verilirse özet bağını da kontrol eder. Kimlik gerekmez.

• GET/api/validation/timestamp/credit

  KamuSM TSA kalan krediyi döner. Bearer API anahtarı gerekir.

Örnek istek

Doğrulama uç noktaları çok parçalı (multipart) dosya yükler. JSON gövde örneği yalnızca meta alanları içindir:

{
  "fileName": "sozlesme.pdf",
  "contentType": "application/pdf"
}