HTTP RPC API - OrbitFlare

Genel Bakış

OrbitFlare RPC düğümleri, JSON-RPC 2.0 spesifikasyonunu kullanarak HTTP isteklerini kabul eder. Bu API, veri sorgulamak ve işlemleri göndermek için Solana blok zinciriyle etkileşim kurmanıza olanak tanır.

İstek Formatı

JSON-RPC isteği yapmak için aşağıdaki özelliklere sahip bir HTTP POST isteği gönderin:

Endpoint: https://fra.rpc.orbitflare.com?api_key=YOUR_LICENSE_KEY
Başlık: Content-Type: application/json
Gövde: Şu alanları içeren JSON nesnesi:

Alan	Tür	Açıklama
`jsonrpc`	string	”2.0” olmalıdır
`id`	string/number	Benzersiz istek tanımlayıcısı
`method`	string	RPC metod adı
`params`	array	Metod parametrelerinin dizisi

Örnek İstek

curl https://fra.rpc.orbitflare.com?api_key=YOUR_LICENSE_KEY -X POST -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getBalance",
  "params": [
    "83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri"
  ]
}'

Yanıt Formatı

Yanıtlar şunları içeren JSON nesneleri olacaktır:

Alan	Tür	Açıklama
`jsonrpc`	string	Her zaman “2.0”
`id`	string/number	İstek tanımlayıcısıyla eşleşir
`result`	çeşitli	Metodun sonuç verisi
`error`	object	Hata ayrıntıları (varsa)

Onay Seviyesi (Commitment)

Birçok metod, verinin ne kadar onaylanmış olması gerektiğini belirlemek için bir commitment parametresini kabul eder:

processed: En son blok (en hızlı, onaylanmamış)
confirmed: Süper çoğunluk tarafından onaylanmış (hız ile kesinlik arasında denge)
finalized: Süper çoğunluk tarafından sonuçlandırılmış (en yavaş, tam onaylı)

Onay seviyesiyle örnek:

curl https://fra.rpc.orbitflare.com?api_key=YOUR_LICENSE_KEY -X POST -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getBalance",
  "params": [
    "83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri",
    {"commitment": "finalized"}
  ]
}'

Toplu İstekler

Bir dizi istek nesnesi sağlayarak tek bir HTTP çağrısında birden fazla istek gönderebilirsiniz:

curl https://fra.rpc.orbitflare.com?api_key=YOUR_LICENSE_KEY -X POST -H "Content-Type: application/json" -d '[
  {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getBalance",
    "params": ["83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri"]
  },
  {
    "jsonrpc": "2.0",
    "id": 2,
    "method": "getBlockHeight",
    "params": []
  }
]'

Ortak Türler

Tür	Açıklama
Pubkey	Base-58 kodlu açık anahtar dizisi
Hash	Base-58 kodlu SHA-256 hash dizisi
Signature	Base-58 kodlu Ed25519 imzası
Slot	Tamsayı blok yüksekliği/slot numarası

Sağlık Kontrolü

Düğüm sağlığını bir GET isteğiyle kontrol edebilirsiniz:

curl "https://fra.rpc.orbitflare.com/health?api_key=YOUR_LICENSE_KEY"

Olası yanıtlar:

ok: Düğüm sağlıklı ve güncel
behind { slots: number }: Düğüm N slot geride
error: Düğüm sağlıksız

Kullanılabilir Metodlar

Hesap & Program

getAccountInfo
getMultipleAccounts
getProgramAccounts
getMinimumBalanceForRentExemption

Bloklar & Slotlar

getBlock
getBlocks
getBlockHeight
getSlot
getSlotLeader

İşlemler

getTransaction
getSignatureStatuses
getSignaturesForAddress
sendTransaction
simulateTransaction

Token'lar

getTokenAccountBalance
getTokenAccountsByDelegate
getTokenAccountsByOwner
getTokenSupply

Hız Sınırları

Hız sınırları abonelik katmanına göre değişir. Plan başına kesin RPS ve TPS değerleri için Kimlik Doğrulama & Limitler sayfasına bakın.

En İyi Uygulamalar

Uygun Onay Seviyelerini Kullanın
- Arayüz güncellemeleri için processed kullanın
- Çoğu işlem için confirmed kullanın
- Kritik işlemler için finalized kullanın
İstekleri Optimize Edin
- Mümkün olduğunda toplu istekler kullanın
- Uygun önbelleğe alma uygulayın
- Uygun yoklama aralıklarını seçin
Hataları Yönetin
- Uygun hata yönetimi uygulayın
- Yeniden denemeler için üstel geri çekilme kullanın
- İstek başarısızlıklarını izleyin

Ayrıca Bakınız

Kimlik Doğrulama & Limitler

API anahtarı kurulumu, endpoint formatları, hız sınırları ve bağlantı limitleri.

Hata Kodları

HTTP durum kodları, JSON-RPC hataları ve bunların nasıl yönetileceği.

WebSocket API

Hesaplar, slotlar, günlükler ve daha fazlası için gerçek zamanlı abonelikler.

Destek

RPC hizmetimiz hakkında teknik destek veya sorularınız için:

Discord topluluğumuza katılın
Durum sayfamıza göz atın
Destek ekibimizle iletişime geçin

​Genel Bakış

​İstek Formatı

​Örnek İstek

​Yanıt Formatı

​Onay Seviyesi (Commitment)

​Toplu İstekler

​Ortak Türler

​Sağlık Kontrolü

​Kullanılabilir Metodlar