Ana sayfa
SwaggerKayıt ol

v1.0 · REST API

API referansı

PDF damgalama, TÜBİTAK onaylı zaman damgası metadata'sı ve herkese açık doğrulama. Entegrasyon örnekleri aşağıdadır.

https://trust.cronwork.com/api/v1

Resmi entegrasyon

TÜBİTAK onaylı resmi zaman damgası

Cronwork Trust, belgelerinize yalnızca dahili bir hash üretmez. Her damgalama işleminde TÜBİTAK onaylı nitelikli elektronik zaman damgası uygulanır; referans damgalı PDF alt bilgisinde, API yanıtında ve herkese açık doğrulama sayfasında yer alır.

Ulusal TSZ uyumlu
Onaylı altyapı

TÜBİTAK onayı

Ulusal standartlara uygun zaman damgası

Nitelikli elektronik zaman damgası hizmeti, TÜBİTAK bünyesindeki ulusal kriptografi ve güven altyapısı ile uyumlu şekilde sunulur.

Teknik otorite

TÜBİTAK BİLGEM UEKAE

Ulusal Elektronik ve Kriptografi Araştırma Enstitüsü

Türkiye'nin elektronik sertifika ve zaman damgası teknik otoritesi; ulusal güven kökü ve TSZ standartlarının merkezi.

Hukuki çerçeve

5070 sayılı kanun

Elektronik İmza Kanunu

Nitelikli elektronik zaman damgası, elektronik verinin belirli bir zamandaki varlığını ve bütünlüğünü güvenilir biçimde kanıtlar.

Resmi geçerlilik

Hukuki delil

Yargı ve kamu süreçleri

TÜBİTAK onaylı nitelikli zaman damgalı belgeler, Türk hukuk sisteminde güçlü delil değeri taşır; mahkeme ve idari süreçlerde kabul edilir.

Teknik ve hukuki özet

  • • TÜBİTAK onayı — Ulusal elektronik sertifika ve zaman damgası altyapısı ile uyumlu, ETAK çerçevesinde yetkilendirilmiş hizmet modeli.
  • • Nitelikli elektronik zaman damgası — 5070 sayılı Elektronik İmza Kanunu kapsamında; elektronik verinin belirli bir zamandaki varlığını ve değiştirilmediğini kanıtlar.
  • • Mahkeme kabulü — TÜBİTAK onaylı zaman damgalı belgeler, HMK ve ilgili mevzuat çerçevesinde güçlü delil niteliği taşır; yargı organları ve kamu kurumları tarafından tanınır.
  • • Şeffaf doğrulama — Üçüncü taraflar /verify/:token ile resmi referansı ve hash değerini doğrulayabilir; belge içeriği ifşa edilmez.

Bu sayfadaki bilgiler genel bilgilendirme amaçlıdır. Özel hukuki durumunuz için kurum avukatınıza danışmanız önerilir.

Başlarken

Tüm istekler https://trust.cronwork.com/api/v1 taban URL'sine yapılır. Damgalama uç noktaları API anahtarı ile; panel işlemleri JWT Bearer ile korunur.

API anahtarı

ts_live_… ile stamp çağrıları

1 test kredisi

E-posta + SMS doğrulama sonrası

Resmi referans

Her yanıtta TÜBİTAK onaylı damga bilgisi

Hızlı başlangıç

# 1. Kayıt + doğrulama (panel: /onay)
# 2. Dashboard'dan API anahtarı oluştur
# 3. PDF damgala:
curl -X POST https://trust.cronwork.com/api/v1/stamp \
  -H "X-API-KEY: ts_live_..." \
  -F "pdf=@belge.pdf" \
  -F "title=Sözleşme" \
  -F 'signerInfo={"name":"Ad Soyad"}'

Kimlik doğrulama

Kayıt sonrası e-posta ve telefon OTP ile doğrulama zorunludur. Tamamlanınca 1 ücretsiz kredi tanımlanır.

POST/auth/register

Kayıt ol

Yeni hesap oluşturur. Başlangıç kredisi 0'dır; e-posta ve telefon doğrulaması tamamlandığında 1 ücretsiz test kredisi tanımlanır.

curl -X POST https://trust.cronwork.com/api/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "ornek@sirket.com",
    "password": "GucluSifre123!",
    "phone": "05551234567",
    "companyName": "Örnek A.Ş."
  }'

Örnek yanıt

{
  "token": "eyJhbG...",
  "user": { "credits": 0, "emailVerified": false, ... },
  "verification": { "welcomeCreditsAmount": 1, ... }
}

Doğrulama uç noktaları

  • POST /auth/verify/email — { code }
  • POST /auth/verify/phone — { code }
  • POST /auth/resend/email · POST /auth/resend/phone
  • GET /auth/verification-status

API anahtarı

Panelden veya JWT ile /developer/keys uç noktasından ts_live_ önekli anahtar üretin. Anahtar yalnızca oluşturulduğunda bir kez gösterilir.

PDF damgalama

multipart/form-data ile PDF gönderin. Sistem sırasıyla: orijinal hash → TÜBİTAK onaylı zaman damgası → sayfa alt bilgisi + QR.

POST/stampX-API-KEY

PDF damgala

Orijinal PDF yüklenir; SHA-256 hash hesaplanır, TÜBİTAK onaylı nitelikli zaman damgası uygulanır ve her sayfaya QR kodlu resmi alt bilgi eklenir. 1 kredi düşülür.

curl -X POST https://trust.cronwork.com/api/v1/stamp \
  -H "X-API-KEY: ts_live_xxxxxxxx" \
  -F "pdf=@/path/to/sozlesme.pdf" \
  -F "title=Hizmet Sözleşmesi" \
  -F 'signerInfo={"name":"Ahmet Yılmaz","role":"İmzalayan"}'

Örnek yanıt

{
  "id": "clx...",
  "verifyToken": "uuid",
  "hash": "sha256...",
  "officialTimestamp": {
    "provider": "TÜBİTAK",
    "reference": "TTD-...",
    "legalBasis": "5070 sayili Elektronik Imza Kanunu...",
    "validityNote": "Turkiye'de resmi ve hukuki delil niteligi..."
  },
  "verifyUrl": "https://trust.cronwork.com/verify/uuid",
  "pdfDownloadUrl": "https://trust.cronwork.com/api/v1/stamp/{id}/download",
  "creditsRemaining": 42
}

Doğrulama

Kimlik doğrulama gerekmez. QR kod veya paylaşılan link ile metadata doğrulanır.

GET/verify/:token

Belge doğrula (herkese açık)

Doğrulama kodu ile belgenin TÜBİTAK onaylı zaman damgası ve hash metadata bilgilerini döner. Ham PDF içeriği asla paylaşılmaz.

curl https://trust.cronwork.com/api/v1/verify/BELGE_VERIFY_TOKEN

Örnek yanıt

{
  "verified": true,
  "title": "Hizmet Sözleşmesi",
  "officialTimestamp": { "provider": "TÜBİTAK", "reference": "TTD-...", "legalBasis": "..." },
  "stampedAt": "2026-06-03T12:00:00.000Z",
  "hash": "a3f8c2..."
}

Kredi ve ödeme

1 kredi = 1 PDF damgası. Listelenen fiyatlar KDV hariçtir (kredi başına ₺6'dan ₺3'e hacim indirimi). Satın alımlar kurumsal olarak faturalandırılır. Geliştirme ortamında mock ödeme modu desteklenir.

GET/creditsBearer veya X-API-KEY

Kalan kredi

JWT veya API anahtarı ile hesaptaki kalan damga kredisini sorgular.

curl https://trust.cronwork.com/api/v1/credits \
  -H "X-API-KEY: ts_live_xxxxxxxx"

Örnek yanıt

{ "credits": 87, "email": "ornek@sirket.com" }
GET /billing/packages · POST /billing/checkout · GET /billing/iyzico/callback · POST /billing/mock-complete (dev)

Hata kodları

HTTPAnlam
400Geçersiz istek / doğrulama hatası
401Yetkisiz — JWT veya API anahtarı eksik/hatalı
402Yetersiz kredi
404Kayıt bulunamadı
409E-posta veya telefon zaten kayıtlı
500Sunucu hatası

OpenAPI / Swagger

Makine okunur şema ve interaktif deneme için Swagger UI kullanılabilir. Günlük entegrasyon için bu sayfadaki örnekler yeterlidir.

Swagger UI'ı aç

Cronwork Trust · TÜBİTAK onaylı zaman damgası API'si