DIPAPI Dokumantasyonu
v1

Polling

GET /v1/jobs/{id} polling fallback'idir — webhook basarisiz olsa dahi istemci her zaman bu endpoint'e guvenebilir.

Status enum

queued -> processing -> parsing -> indexing -> completed / failed
  • result alani yalnizca status: "completed" iken doludur.
  • error alani yalnizca status: "failed" iken doludur; bu durumda result null doner.
  • markdown_url ve json_url sureli signed link'lerdir — her GET cagrisinda taze uretilir (lazy signing). Linki onbelleklemeyin, suresi dolar.

GET /v1/jobs/{id}

Bir document'in guncel durumunu doner. Alanlar:

  • id, batch_id, external_item_ref, external_batch_ref
  • status, page_count, file_size_bytes
  • result.markdown_url, result.json_url (yalnizca completed)
  • error (yalnizca failed)
  • created_at, updated_at, completed_at

Hata: 404 not_found — id yok ya da baska bir tenant'a ait.

GET /v1/batches/{id}

Bir batch'in ve icindeki tum document'lerin durumunu doner. Batch status'u turetilmis bir alandir: tum document'ler completed/failed ise batch completed, en az biri islenmekte ise processing.

Onerilen polling stratejisi

  • Baslangicta 2-3 saniyede bir kontrol edin.
  • 429 alirsaniz Retry-After header'ina uyup exponential backoff uygulayin.
  • Webhook aliyorsaniz polling'i yalnizca dogrulama/fallback icin kullanin — her iki kanal da ayni son duruma yakinsayacaktir.