Neler faturalandırılmaz: hata kodları ve faturalandırma kuralları

BlockVectra, istekleri Compute Units (CU) cinsinden ölçer. JSON-RPC ve Data API çağrıları yalnızca bir yanıt alındıktan sonra faturalandırılır. Bu rehber, HTTP durum kodları, JSON-RPC çağrıları ve Data API genelindeki faturalandırma belirleme kurallarını geliştiriciler için önerilen eylemlerle birlikte özetler.

HTTP durum kodları ve faturalandırma kuralları

HTTP düzeyindeki yanıtlar için faturalandırma belirleme ve işleme kuralları aşağıdaki gibidir:

Not: Cloudflare üzerinden erişildiğinde, Cloudflare 52x veya 1015 hata sayfaları döndürebilir; bunlar hizmet tarafından üretilmez.

Ücret ve bakiye yanıt başlıkları: HTTP isteklerinde (hem JSON-RPC hem de Data API için geçerlidir) x-bv-meter: 1 gönderildiğinde, en az bir çağrıyı faturalandıran bir yanıt x-bv-cu-charged (bu istek için faturalandırılan Compute Units veya bir toplu işlemin faturalandırılan çağrıları genelindeki toplam) ve x-bv-balance-units (bu ücretten hemen sonra hesabın kalan bakiye birimleri, eksiye düşüldüğünde negatiftir; bakiye bilinmiyorsa atlanır) döndürür. x-bv-meter: 1 olmayan istekler, hiçbir şeyin faturalandırılmadığı yanıtlar ve 402, 403, 429 veya 503 hata yanıtları her iki başlığı da atlar. Bu yanıt başlıklarına CORS aracılığıyla tarayıcı betikleri tarafından erişilebilir; WebSocket bunları kullanmaz. Bakiye, tam birimlere bir kez yukarı yuvarlanan toplam tahakkuk etmemiş kullanımı çıkarır; saatlik tahakkuk aşağı yuvarlar, bu nedenle bildirilen bakiye tahakkuktan sonra bir birime kadar artabilir.

JSON-RPC hata kodları ve faturalandırma kuralları

Aynı hata kodu platformdan veya düğümden kaynaklanabilir ve faturalandırma farklılık gösterir:

• Platformun kendisi tarafından oluşturulan hatalar: asla faturalandırılmaz;
• Düğüm tarafından döndürülen hatalar: olduğu gibi iletilir ve yöntem ağırlığından faturalandırılır; yalnızca aşağıda listelenen düğüm hata kodları istisnadır.

Kural ayrıntıları

• Faturalandırılmayan düğüm hataları: Düğümün -32002 (toplu işlem zaman aşımı), -32003 (toplu işlem yanıtı çok büyük) ve -32600 (toplu işlem bir bütün olarak reddedildi) kodları, düğümün çağrıyı erkenden terk ettiğini gösterir; bunlar ve aynı toplu işlemdeki tüm bildirimler faturalandırılmaz. Düğümün -32601 (açık yöntem uygulanmadı) ve -32603 (düğüm dahili arızası) kodları HTTP veya WebSocket üzerinden faturalandırılmaz ve toplu işlemdeki diğer çağrıları veya bildirimleri etkilemez. Ayrıca 4444 (budanmış blok) ve -32000 (düğümün GET /v1/chains içindeki state_window_blocks ile tanımlanan durum geçmişi penceresinin dışındaki geçmiş durum) faturalandırılmaz ve toplu işlemdeki diğer çağrıları etkilemez.
• Faturalandırılan düğüm hataları: Düğüm tarafından döndürülen diğer hatalar, zincirin sonucunu bildirdiklerinde yöntem ağırlığından faturalandırılır; örneğin execution reverted (-32000 veya data ile 3), düğümün kendi -32602 invalid argument hatası.
• Bakiye kabulü ve senkronizasyonu: -32020 yetersiz hesap bakiyesini gösterir ve bakiye yüklemesi gerektirir; bakiye bilindiğinde error.data.balance_units ve error.data.balance_cu kalan miktarı taşır (negatif olabilir). Yeni oluşturulmuş bir anahtar birkaç saniye boyunca -32021 (503) döndürebilir; Retry-After süresince bekleyip yeniden deneyin.
• Üst kaynak arızaları: Üst kaynak iletişim arızası veya hatalı biçimlendirilmiş yanıt (upstream unavailable, no response from upstream, malformed upstream response) nedeniyle platform tarafından oluşturulan bir -32603, data.reason: upstream_unavailable taşır.
• Bildirim faturalandırması: Bildirimler (204) kendi yöntem ağırlıklarından faturalandırılır.

JSON-RPC hata kodları tablosu

Data API faturalandırma kuralları

Data API, salt okunur zincir verilerini REST uç noktalarına sarar. Faturalandırması ve hata işlemesi şu kuralları izler:

Kural ayrıntıları

• Yalnızca 2xx başarılı yanıtlar faturalandırılır.
• Kapsam dışındaki kullanılamayan işlemler (desteklenmeyen zincirler veya trace kapsamı dışındaki bloklar gibi), faturalandırılmayan ancak hız limitlerine sayılan HTTP 422 no_coverage döndürür.
• HTTP 401, 402, 404 ve 429 yanıtları faturalandırılmaz. Yanıt başlıkları (x-bv-meter: 1) için bkz. HTTP durum kodları ve faturalandırma kuralları.

Data API durum kodları tablosu

Bakiye sorgulama (GET /v1/account)

Bir API key sahibi, herhangi bir faturalandırma oluşturmadan veya Compute Units (CU) düşürmeden bakiye ve anahtar kotası ayrıntılarını doğrudan kontrol edebilir:

curl -H "x-api-key: $BLOCKVECTRA_API_KEY" https://api.blockvectra.com/v1/account

• Ücretsiz ve faturalandırılmaz: GET /v1/account ücretsizdir. Asla faturalandırılmaz, CU düşürmez ve sıfır veya negatif olsa bile geçerli bakiye ile HTTP 200 döndürür (asla 402 döndürmez).
• Kimlik doğrulama: Anahtar kimlik doğrulaması yalnızca x-api-key başlığını kullanır (yol anahtarları ve Bearer token'ları kabul edilmez). Eksik başlık 401 missing_api_key; geçersiz veya iptal edilmiş anahtarlar 401 invalid_api_key döndürür. (Süresi dolmuş anahtarlar 403 key_expired; geçici hizmet kullanılamama durumları Retry-After ile birlikte 503 auth_unavailable veya billing_unavailable döndürür.)
• Hız sınırlaması: CU ölçümünden ve faturalandırmasından bağımsız olarak, anahtar kimliği başına saniyede 5 istek şeklinde bağımsız bir sınıra sahiptir. Sınırın aşılması, Retry-After başlığı ile birlikte HTTP 429 rate_limited döndürür.

Yanıt alanları:

• key_id: API key'in tanımlayıcı dizesi.
• plan: Hesap planı türü (hesabın ücretsiz plan çağrı hızı hakkı olduğunda free; aksi takdirde paid).
• balance_units: Birim cinsinden kalan hesap bakiyesi (sıfır veya negatif olabilir).
• balance_cu: Compute Units (CU) cinsine dönüştürülmüş kalan bakiye.
• balance_as_of_age_ms: Bakiyenin veri kaynağından okunmasından bu yana geçen milisaniye.
• key: Anahtara özel limitler ve kota ayrıntıları:
  • cu_per_sec: Saniyede CU cinsinden token havuzu yenileme hızı.
  • burst_cu: CU cinsinden token havuzu burst kapasitesi.
  • cu_cap: Bu anahtar için ömür boyu CU üst sınırı veya sınırsızsa null.
  • cu_cap_remaining: cu_cap kapsamında kalan CU veya sınırsızsa null (sıfır veya negatif olabilir).
  • expires_at: RFC 3339 sona erme zaman damgası veya anahtarın süresi asla dolmuyorsa null.

Örnek yanıt:

{
  "key_id": "<key_id>",
  "plan": "<plan>",
  "balance_units": <integer>,
  "balance_cu": <integer>,
  "balance_as_of_age_ms": <integer>,
  "key": {
    "cu_per_sec": <integer>,
    "burst_cu": <integer>,
    "cu_cap": <integer_or_null>,
    "cu_cap_remaining": <integer_or_null>,
    "expires_at": "<expires_at_or_null>"
  }
}

Fiyatlandırma ve yükseltmeler

Faturalandırılan tüm çağrıların spesifik maliyeti, yayınlanan CU ağırlıkları tarafından belirlenir:

• Tüm yöntemlerin ve işlemlerin ağırlıklarını incelemek için yöntem ağırlık tablosuna ve JSON-RPC CU Ölçüm Kuralları'na bakın.
• Plan fiyatlandırması ve tahakkuk ayrıntıları için Fiyatlandırma sayfasına bakın.
• Ücretli bir plana yükseltme: ücretli bir bakiye yüklemesi yapmak, Ücretsiz Planın saniye başına çağrı sınırını kaldırır; her anahtar CU hız ve burst limitlerine tabi kalmaya devam eder.

Zincir Üstü Bakiye Yükleme Süreci

Hesap bakiyeniz yetersiz olduğunda veya daha yüksek verimliliğe ihtiyaç duyduğunuzda, konsolda aşağıdaki adımları izleyerek zincir üstünde bakiye yükleyin:

1. Konsolda Oturum Açın: BlockVectra Konsolu'nda oturum açın.
2. Faturalandırma Sayfasına Gidin: Faturalandırma sayfasına gidin.
3. Özel Adresinizi Alın: Zincir üstü yükleme kartında hesabınızın özel bakiye yükleme adresini kopyalayın veya QR kodunu tarayın.
4. Fon Transfer Edin: Yalnızca sayfada listelenen desteklenen ağları ve USDC / USDT / USDG kullanarak transfer yapın. Desteklenen ağlar ve minimum yükleme tutarları konsolda gösterilir.
5. Otomatik Kredi Yükleme: Zincir üstünde tespit edildiğinde işlemler "Processing" olarak görünür; kredilendirildikten sonra krediler bakiyenize otomatik olarak eklenir.

Önemli Notlar:

• Yalnızca konsolda açıkça listelenen ağları ve token'ları kullanın. Desteklenmeyen zincirlerdeki veya yanlış token'larla yapılan transferler otomatik olarak hesaba aktarılamaz.
• Her transferin konsolda belirtilen minimum yükleme tutarını karşıladığından emin olun.
• İlk ücretli bakiye yüklemeniz hesaba aktarıldığında hesabınız ücretli bir hesaba yükseltilir ve Ücretsiz Planın saniye başına çağrı sınırı kaldırılır.

Agent veya sunucu programları, bir API key kullanarak bakiye yükleme uç noktalarını doğrudan çağırabilir; bkz. Agent programatik bakiye yükleme rehberi.

Webhook push faturalandırması

Push bildirimlerinin iletilen veri olayları, başarılı geçmiş sorguları ve faturalandırılabilir adres-günler için ayrı ağırlıkları vardır. Olay geçmişi dışındaki yönetim çağrıları, başarısız teslimat denemeleri, otomatik yeniden denemeler ve kontrol olayları ücretsizdir. Teslim edilen her olay bir kez ücretlendirilir; müşteri tarafından yeniden oynatma ve bir reorg sonrasında yeniden teslim edilen kurallı olaylar yeni faturalandırılan teslimatlardır. Adres ücretleri, her aboneliğin UTC günü boyunca çevrimiçi olduğu süredeki maksimum adres sayısını kullanır; hesaptaki ücretsiz adres hakkı abonelikler arasında paylaşılır ve daha eski abonelikler bunu önce kullanır. İki abonelikte yer alan bir adres iki kez sayılır; zincir eklemek olay ücretlerini değiştirir, adres ücretlerini değiştirmez.

Kurulum, imza doğrulama ve teslimat kurtarma için Blokzincir Webhook API rehberine bakın. Stabil kripto para ödeme rehberi, makbuz doğrulama ve yoklama ile geriye dönük doldurmayı kapsar; WebSocket abonelikleri kendi bağlantı ve bildirim ölçümünü kullanır. İstek hataları hata referansında listelenmiştir. Aşağıdaki ağırlıklar GET /v1/plans üzerinden gelir.

Sonraki adımlar

• BlockVectra'nın indekslediği her veri kümesini görmek için veri kümeleri dizinine göz atın.
• Hesabınızın neleri içerdiğini kontrol etmek için ücretsiz planı ve fiyatlandırmayı inceleyin.
• Bir API key oluşturmak için konsolda oturum açın.