Okuma ve dışa aktarım

Silinen kayıtlar hiçbir okuma yolundan dönmez: değişiklik akışı, dışa aktarım parçaları ve tekil okumalar yalnızca canlı veriden üretilir.

Değişiklik akışı

GET /v1/changes?cursor=head&limit=100&wait=30

Olaylar: chunks.published, deletion.accepted, epoch.rolled, erasure.completed. Yanıt next_cursor taşır. İmleç opaktır; limit en fazla 1.000, wait en fazla 30 saniyedir ve olaylar 30 gün tutulur. Süresi dolmuş bir imleç 410 cursor_expired döndürür; bu durumda bir dışa aktarım başlatıp onun as_of_cursor değerinden devam edin.

Dışa aktarım

POST /v1/exports
{"partitions": ["orders"], "from_day": "2026-09-01", "to_day": "2026-09-30"}

• Yanıt 201 (hazır) ya da 202 (onay bekliyor) olur.
• Parçalar GET /v1/exports/{id}/parts/{n} ile NDJSON olarak akar; Reindeer-Records ve Reindeer-SHA256 sonek başlıklarıyla doğrulanır.
• Bir dışa aktarım parçası sekiz veri parçasını (chunk) kapsar; dışa aktarımlar yedi gün sonra sona erer.

Şu dışa aktarımlar ikinci bir kişinin onayını bekler: hiçbir bölüm ya da gün belirtmeyen tam dışa aktarımlar, 24 saat içinde bir kimlik için 5.000.000 ya da tüm kimlikler için 10.000.000 kaydı aşanlar ve canlı verinin yarısını geçenler.

Tekil okuma

GET /v1/records/{record}?day=2026-09-20&partition=tr

Kaydın en yeni canlı sürümünü döndürür. Tekil okumalar erişim kaydına girer; kayıt kimliği kayda takma adıyla yazılır.

Bölümler

GET /v1/partitions yayınlanmış bölümleri, gün aralıklarını, kayıt ve parça sayılarını ve boyutlarını listeler.