docufykit.comVerify. Extract. Deliver.
Giriş yapHızlı başlangıç

POST /v1/verifications musteri akisinin baslangicidir. Verification isini awaiting_upload durumunda olusturur ve belge baytlari icin dogrudan yukleme hedefini dondurur.

Endpoint

POST https://api.docufykit.com/v1/verifications

Ornek istek

curl -X POST "https://api.docufykit.com/v1/verifications" \
  -H "X-API-Key: <api-anahtariniz>" \
  -H "Idempotency-Key: 4dd2b36b-8f7c-4f8a-8fb5-1f2d27c3c0f1" \
  -H "Content-Type: application/json" \
  -d '{
    "document_type": "YOK_STUDENT",
    "process_type": "async",
    "external_reference_id": "student-12345",
    "original_filename": "belge.pdf",
    "file_size_bytes": 160585,
    "metadata": {
      "customer_user_id": "usr_12345"
    }
  }'

Onemli request alanlari

  • document_type: bugun opsiyoneldir, ancak beklenen semayi biliyorsaniz onerilir.
  • process_type: sync veya async. Quickstart'taki mevcut davranista bos birakilirsa varsayilan sync olur.
  • external_reference_id: sizin mutabakat kimliginiz.
  • original_filename: sadece izlenebilirlik icin.
  • file_size_bytes: beyan edilen yukleme boyutu. Daha sonraki upload-complete adimi stored object'i bu degerle karsilastirir.
  • metadata: sonuclarda ve webhook'larda size geri donen serbest JSON.

Ornek response yapisi

Ilk olusturma 201 Created dondurur. Ayni app ayni Idempotency-Key ile tekrar denerse API duplicate uretmek yerine mevcut isi 200 OK ile geri dondurebilir.

{
  "verification_id": "ver_123",
  "document_type": "YOK_STUDENT",
  "status": "awaiting_upload",
  "reason_code": "awaiting_upload",
  "process_type": "async",
  "external_reference_id": "student-12345",
  "original_filename": "belge.pdf",
  "file_size_bytes": 160585,
  "message": "upload URL created; upload the file and confirm completion to start processing",
  "upload": {
    "method": "PUT",
    "url": "https://storage.example.com/...",
    "expires_at": "2026-03-07T12:34:56Z"
  }
}

Create adimi ne yapar ve ne yapmaz

Create asamasinda platform:

  • JSON request'ini dogrular
  • verification isini kaydeder
  • awaiting_upload ve reason_code=awaiting_upload atar
  • imzali bir upload hedefi dondurur

Create asamasinda platform henuz sunlari yapmaz:

  • yuklenen baytlari incelemez
  • gercek content type'i bilmez
  • terminal karar dondurmez
  • structured_data uretmez

Sonraki sayfalar