Upload

Dokuman yuklemenin iki yolu vardir: coklu dosya icin batch, tek dosya icin dogrudan document kisayolu. Her iki yol da ayni ardindaki Batch/Document kaynaklarini olusturur.

POST /v1/batches

multipart/form-data govdesi ile bir ya da birden fazla dosya yuklenir.

Alanlar:

• metadata (zorunlu) — JSON string parcasi:
  • external_batch_ref (opsiyonel) — kendi sisteminizdeki batch referansi.
  • callback_url (opsiyonel) — bos birakilirsa tenant'in varsayilan webhook adresi kullanilir.
  • items[] — her biri key (dosya parcasinin adi) ve opsiyonel external_item_ref icerir.
• Her items[].key icin ayni isimde bir dosya parcasi (item_0, item_1, ...) gonderilir.

id degerleri her zaman aninda doner — istemci parse islemi bitmesini beklemeden batch.id ve document.id'leri alir; sonraki adim polling ya da webhook ile takiptir.

POST /v1/documents

Tek dosya yuklemek icin kisayol; arka planda tek elemanli bir batch olusturur. Alanlar: file (zorunlu), external_item_ref, external_batch_ref, callback_url (hepsi opsiyonel).

Cevap, GET /v1/jobs/{id} ile ayni semaya sahip tek bir document objesidir, status: "queued" ile.

Hatalar

| HTTP | code | Aciklama | | --- | --- | --- | | 400 | invalid_request | metadata / items uyusmazligi | | 402 | insufficient_credit | Bakiye, kaba dosya boyutu tahminiyle yapilan on-kontrolde yetersiz | | 413 | payload_too_large | Dosya boyutu limiti asildi | | 422 | unprocessable_file | Herhangi bir dosya formati desteklenmiyor — tum batch reddedilir, kismi kabul yoktur |

Batch icindeki dosyalardan biri gecersiz formatli ise butun istek reddedilir; gecerli dosyalari ayiklayip yeniden gondermeniz gerekir.