Bitcoin RPC Endpoint Dokümantasyonu | ERPC
Bitcoin RPC Endpoint Dokümantasyonu
ERPC'yi HTTP JSON-RPC istekleri için Bitcoin RPC endpoint'iniz olarak kullanabilirsiniz. Bitcoin RPC, Global Edge Blockchain Infrastructure'ımız kapsamındaki ERPC'nin RPC APIs'inin bir parçasıdır ve API key, ERPC Web Dashboard üzerinden yönetilebilir.
Solana, Ethereum ve Avalanche ile aynı RPC key'i kullanabilirsiniz.
API key'inizi
api-key query parametresiyle iletin ya da Authorization: Bearer <YOUR_API_KEY> olarak gönderin. İkisi birlikte gönderilirse query parametresi kullanılır.Endpoints
JSON-RPC isteklerini HTTP POST olarak şuraya gönderin:
text
https://edge.erpc.global/bitcoin?api-key=<YOUR_API_KEY>https://edge.erpc.global/bitcoin?api-key=<YOUR_API_KEY>ya da özel host'a:
text
https://bitcoin.erpc.global?api-key=<YOUR_API_KEY>https://bitcoin.erpc.global?api-key=<YOUR_API_KEY>İstekler yalnızca
/ yolunda kabul edilir.Örnekler
Aşağıda, API key'in query parametresinde gönderildiği bir HTTP istek örneği yer alır.
bash
curl 'https://edge.erpc.global/bitcoin?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
"jsonrpc":"1.0","id":1,
"method":"getblockcount",
"params":[]
}'curl 'https://edge.erpc.global/bitcoin?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
"jsonrpc":"1.0","id":1,
"method":"getblockcount",
"params":[]
}'Aşağıda, API key'in
Authorization başlığında gönderildiği aynı istek yer alır.bash
curl 'https://edge.erpc.global/bitcoin' --header 'Content-Type: application/json' --header 'Authorization: Bearer <YOUR_API_KEY>' --data '{
"jsonrpc":"1.0","id":1,
"method":"getblockcount",
"params":[]
}'curl 'https://edge.erpc.global/bitcoin' --header 'Content-Type: application/json' --header 'Authorization: Bearer <YOUR_API_KEY>' --data '{
"jsonrpc":"1.0","id":1,
"method":"getblockcount",
"params":[]
}'Bitcoin,
jsonrpc değeri olarak 1.0 veya 2.0 kabul eder ya da bu alanın hiç gönderilmemesine izin verir; her çağrının bir id değeri olmalıdır.API key'inizi ERPC Web Dashboard üzerinden alabilir ve kontrol edebilirsiniz: ERPC Web Dashboard
Toplu İstekler
HTTP isteği başına 1 ile 100 arasında çağrı içeren JSON-RPC toplu istekleri desteklenir. Her çağrının kendine ait bir
id değeri olmalıdır ve bir toplu istek içinde id değerleri tekrar etmemelidir. Bir toplu istekteki her çağrı kendi başına bir çağrı olarak ücretlendirilir. İstek gövdesi en fazla 1 MiB olabilir.Kullanım Ücretlendirmesi
Kullanım token cinsinden ücretlendirilir ve token oranı yönteme göre değişebilir. Bir HTTP toplu isteğindeki her çağrı ayrı ayrı ücretlendirilir.
Free Plan Sınırları
Free planda hesabınız 10 saniyede bir istek gönderebilir. Sınır endpoint başına değil, hesap başına sayılır; bu nedenle başka bir zincire gönderilen bir istek de bu sınıra dahil edilebilir. Daha erken gönderilen bir istek HTTP
429 ile yanıtlanır ve retry-after başlığı bekleme süresini saniye cinsinden verir.Free planda, iki veya daha fazla JSON-RPC çağrısı içeren bir istek HTTP
429 ile yanıtlanır ve çağrılarının hiçbiri gönderilmez: her çağrı -32041 koduyla bir JSON-RPC hatası alır. Bunun yerine bu çağrıları tek tek gönderin.Desteklenen Yöntemler
Endpoint, şu 32 Bitcoin Core JSON-RPC yöntemini sunar.
decoderawtransaction, decodescript, estimatesmartfee, getbestblockhash, getblock, getblockchaininfo, getblockcount, getblockfilter, getblockhash, getblockheader, getblockstats, getchaintips, getchaintxstats, getconnectioncount, getdifficulty, getmempoolancestors, getmempooldescendants, getmempoolinfo, getmininginfo, getnetworkinfo, getrawmempool, getrawtransaction, gettransaction, gettxout, gettxoutproof, gettxoutsetinfo, sendrawtransaction, testmempoolaccept, validateaddress, verifychain, verifymessage, verifytxoutproofListede olmayan bir yöntem HTTP
400 ile yanıtlanır.Yanıt Durum Kodları
| HTTP status | Anlamı |
|---|---|
| 200 | Upstream JSON-RPC yanıtı. JSON-RPC hataları da HTTP 200 ile döner: istekteki id ve error.code korunur, error.message değeri ERPC upstream error olur ve error.data döndürülmez. |
| 400 | Desteklenen Yöntemler listesinde olmayan bir yöntem veya yol, geçersiz bir JSON-RPC isteği, boş bir toplu istek veya 100'den fazla çağrı içeren bir toplu istek, bir toplu istekte yinelenen bir id ya da 1 MiB sınırını aşan bir gövde. |
| 401 | Eksik veya geçersiz API key ya da anahtar için tanımlanan IP veya Origin kısıtlamasının karşılanmaması. |
| 405 | POST dışında bir HTTP istek yöntemi. |
| 426 | WebSocket Upgrade istendi. Endpoint yalnızca HTTP üzerinden çalışır. |
| 429 | Hız sınırlaması uygulandı; yukarıdaki Free plan sınırları da buna dahildir: 10 saniyede birden fazla istek veya tek bir istekte iki ya da daha fazla çağrı. retry-after başlığı varsa, belirtilen saniye kadar bekleyin. |
| 502 | Upstream isteği tamamlanamadı: upstream başarısız bir yanıt döndürdü, yanıt 8 MiB sınırını aştı ya da 30 saniye içinde yanıt gelmedi. |
| 503 | Hizmet geçici olarak kullanılamıyor. |
Bitcoin RPC Yöntemleri ve Dokümantasyon
Tüm standart yöntemler, parametreler ve özellikler için lütfen resmi dokümantasyona bakın.