Veri yükleme

Oturum açmak

POST /v1/ingest-sessions

Bir oturum; bölüm etiketini, kipi ve kayıtları okuyacak JSON işaretçilerini taşır:

Alan	Örnek	Anlamı
partition	orders	Kayıtların bölümü
mode	initial ya da incremental	İlk yükleme commit anında, artımlı yükleme her doğrulanan partide yayınlanır
pointers.id	/order_id	Kayıt kimliği: dizge (en fazla 256 bayt) ya da sayı
pointers.author	/buyer_id	Sahip kimliği: kaydın ait olduğu kişi, hesap ya da cihaz
pointers.ts	/placed_at	Zaman damgası
pointers.ts_format	rfc3339	Zaman biçimi: rfc3339, unix, unix_ms ya da twitter

Oturum oluşturma Idempotency-Key başlığını destekler.

Kuru çalıştırma

POST /v1/ingest-sessions/{sid}/dry-run

İlk 1.000 satırı doğrular ve reddedilme nedenlerine göre sayılar döndürür. Hiçbir içerik geri gönderilmez ve hiçbir şey saklanmaz.

Parti göndermek

PUT /v1/ingest-sessions/{sid}/batches/{n}
Content-Digest: sha-256=:<base64>:
Content-Encoding: zstd

• Gövde NDJSON’dır; Content-Encoding zstd ya da identity olabilir.
• Content-Digest zorunludur; özet tutmazsa hiçbir şey saklanmaz.
• Partiler oturum, numara ve özete göre tekrarlanabilir. Kullanılmış bir numarayla farklı içerik 409 batch_exists döndürür.

Commit

POST /v1/ingest-sessions/{sid}/commit

Commit, kayıt, parça ve parti sayılarını ve yayın durumunu içeren EdDSA imzalı bir JWS makbuz döndürür. Oturumu iptal etmek için DELETE /v1/ingest-sessions/{sid}.

Sınırlar

Sınır	Değer
Kayıt yükü	En fazla 1 MiB
Parti (gönderildiği hâliyle)	En fazla 256 MiB
Parti (açıldığında)	En fazla 4 GiB
JSON derinliği	64
Parti numarası	1 ile 1.000.000 arası
Parça	En fazla 256 MiB ya da 200.000 kayıt
Parti süre bütçesi	1 saat