API temelleri

Tüm uç noktaların ayrıntıları API başvurusunda yer alır.

Kimlik doğrulama

• Makineler: TLS 1.3 üzerinde karşılıklı TLS; sertifika hücrenin istemci CA’sından gelir.
• Kişiler: passkey ile girişten dönen oturum belirteci, Authorization: Bearer <belirteç> başlığında.
• Tarayıcı istekleri izinli bir Origin taşımalıdır. API çerez kullanmaz.

GET /v1/meta kimlik doğrulama gerektirmez; rolü (cell ya da platform), kiracıyı, bölgeyi, sürümü ve passkey alan adını bildirir.

Hatalar

Hatalar RFC 9457 application/problem+json biçimindedir:

{"status": 409, "code": "not_decidable", "title": "Conflict", "detail": "...", "type": "https://reindeer.invalid/problems/not_decidable"}

Kararlı alan code’dur. 429 ve 503 yanıtları Retry-After taşır.

Tekrar güvenliği

Oturum oluşturma, dışa aktarımlar ve silmeler Idempotency-Key (en fazla 255 karakter, yedi gün tutulur) kabul eder:

• Aynı anahtarla tekrar, saklanan yanıtı Idempotency-Replayed: true ile döndürür.
• İlk istek sürerken 409 idempotency_in_flight.
• Farklı bir gövdeyle 422 idempotency_mismatch.

İmleçler ve sayfalama

Değişiklik akışı opak bir cursor (ya da head), limit ve wait alır ve next_cursor döndürür. Günlükler ve denetim olayları after ya da before ve limit ile sayfalanır.

Sınırlar ve süre bütçeleri

Sınır	Değer
İstek hızı	Kimlik başına saniyede 50, anlık 100
Varsayılan süre bütçesi	30 saniye
Değişiklik akışı	90 saniye
Kuru çalıştırma	5 dakika
Onay kararı	6 dakika
Silme talebi	10 dakika
Parti yükleme	1 saat
Dışa aktarım parçası	6 saat

Süre bütçesini aşan ve değişikliği henüz saklanmamış bir istek 503 timeout döndürür; saklanmış bir değişiklik her zaman yanıtlanır.