Mevcut Uç Noktalar
Jetstream, tüm OrbitFlare bölgelerinde kullanılabilir. En düşük gecikme için altyapınıza en yakın bölgeye bağlanın.- US
- Europe
- Asia Pacific
Jetstream, gRPC bağlantıları için düz
http:// kullanır (https:// değil). gRPC, HTTP/2 üzerinde kendi taşıma güvenliği müzakeresini kullanır. https:// yalnızca özel düğümünüz bunu açıkça gerektiriyorsa kullanın.Protocol Buffer Belirtimi
Bu belge, OrbitFlare Jetstream tarafından kullanılan Protocol Buffer (protobuf) belirtimini özetlemektedir. Tam belirtim GitHub depomuzdaki belgede bulunabilir.Hizmet Tanımı
İstek Mesajları
SubscribeRequest
Veri güncellemelerine abone olmak için ana istek mesajı:İşlem Filtreleme
Hesap Filtreleme
Ping İsteği
Yanıt Mesajları
SubscribeUpdate
Güncellemeleri içeren ana yanıt mesajı:İşlem Güncellemesi
Hesap Güncellemesi
Ping/Pong Güncellemeleri
Paylaşılan Türler
Ayrıştırılmış Talimat Desteği
Ayrıştırılmış İstek
Ayrıştırılmış İşlem Güncellemesi
Talimat Türleri
Akışsız Metotlar
Protokolü Kullanma
Jetstream için bir istemci uygularken şunları yapmanız gerekecektir:- Protobuf tanımından istemci kodu oluşturma
- Veri akışı için Subscribe RPC metodunu uygulama
- Ayrıştırılmış talimat desteği için SubscribeParsed kullanma
- Bağlantı sağlık kontrolleri için Ping/Pong kullanma
- Sunucu uyumluluğunu kontrol etmek için GetVersion kullanma
- Farklı türdeki güncellemeleri işleme (işlemler, hesaplar, pong’lar)
Kod Oluşturma
TypeScript/JavaScript için:En İyi Uygulamalar
-
Sürüm Uyumluluğu
- Protokol uyumluluğunu kontrol etmek için GetVersion kullanın
- Beta sürümlerindeki kırıcı değişiklikler için izleyin
- Yükseltme yaparken kapsamlı test yapın
-
Hata İşleme
- Tüm mesaj türleri için uygun hata işleme uygulayın
- Bağlantı hatalarını zarif bir şekilde yönetin
- İşlemeden önce mesaj alanlarını doğrulayın
-
Bağlantı Yönetimi
- Bağlantı sağlık kontrolleri için Ping/Pong kullanın
- Otomatik yeniden bağlanma mantığı uygulayın
- Uygun zaman aşımı değerleri belirleyin
-
Performans
- Gereksiz veriyi en aza indirmek için uygun filtreler kullanın
- Büyük veri kümeleri için hesap filtrelemesini düşünün
- Özellikle hesap aboneliklerinde kaynak kullanımını izleyin
- Gerektiğinde ayrıştırılmış talimat desteği için SubscribeParsed kullanın
Ayrıca Bakınız
Jetstream Genel Bakış
Başlangıç kılavuzu, örnekler ve filtreleme belgeleri.
Değişiklik Günlüğü
Sürüm geçmişi ve protokol güncellemeleri.