Mesaj akışı (kaldığın yerden)
GET/messages
Kiracının tüm mesajları tek akışta, kesin ve değişmez sırayla. /conversations → her kişi için
/contacts/{id}/messages → istemci tarafında diff üçlemesinin yerine geçer.
İmleç: yanıttaki next_cursor değerini bir sonraki isteğe since olarak verin. İmleç opaktır
(fd_…), günlerce geçerlidir ve istemcide kalıcı saklanmalıdır. since verilmezse akış en baştan başlar.
Garanti — en az bir kez (at-least-once): aynı mesaj tekrar dönebilir; mesajın id alanıyla
tekilleştirin. Kayıp olmaz.
Sıra neden id değil: veritabanı kimliği kayıt yazılmadan ÖNCE ayrılır, dolayısıyla küçük
kimlikli bir mesaj büyük kimlikli birinden SONRA görünür olabilir. Böyle bir anda id ile ilerleyen
bir istemci aradaki mesajı kalıcı olarak atlar. Bu uçtaki sıra numarası kayıt kesinleştikten sonra
verilir; bu yüzden bir kez geçtiğiniz noktanın gerisine sonradan mesaj düşmez.
Henüz kesinleşmemiş mesajlar teslim edilmez — bir sonraki çağrıda sıralarıyla birlikte gelirler. Yani akış şüphe anında atlamaz, bekler. Bu nedenle çok kısa (saniyeler mertebesinde) bir gecikme normaldir.
Sistem mesajları (system_*) akışa dahil değildir.
Request
Responses
- 200
- 400
- 401
- 403
- 429
Mesaj akışı
Response Headers
Pencere başına izinli istek
Pencerede kalan istek
Sıfırlanmaya kalan saniye
Geçersiz istek
Anahtar eksik/geçersiz/iptal
Anahtarda gerekli scope yok
Hız limiti / kota aşıldı (uygulama başına, saniye penceresi)
Response Headers
Kaç saniye sonra tekrar denenebilir
Pencere başına izin (X-RateLimit-Limit ile aynı)
Kalan istek (X-RateLimit-Remaining ile aynı)
Sıfırlanmaya kalan SANİYE (delta)
Sıfırlanma zamanı — Unix EPOCH (sn)