Kullanım verisi
Entegrasyonlarda en çok hataya yol açan dört davranış: ölçülemeyen değerler, tipe göre boş alanlar, bağlantı sayımı ve ölçümden bağımsız trafik limiti.
Bu davranışlar arıza değildir; hizmet tipine ve arka uca göre verinin nasıl üretildiğini yansıtır.
Ölçülemedi, sıfır değil
Arka uca ulaşılamazsa sayaçlar null döner, 0 dönmez. usage.available alanını kontrol edin; null değerleri sıfır gibi göstermek müşteriye "hiç kullanmamışsın" dedirtir.
const { usage } = (await res.json()).data;
const label = usage.available ? `${usage.gb_used} GB` : "Şu an ölçülemiyor";Tipe göre her zaman boş alanlar
Arıza değil; o arka uç o veriyi üretmiyor.
| Alan | ISP / Datacenter / Gaming | Mobile / Residential |
|---|---|---|
success_count | ✓ | null |
error_count | ✓ | null |
active_connections | null | ✓ |
source | logs | proxy_controller |
ISP ailesinde istek = bağlantı
ISP, Datacenter ve Gaming'de total_requests, success_count, error_count ve kullanım geçmişindeki requests bağlantı sayar; tek bir keep-alive bağlantı birden çok HTTP isteği taşıyabilir. bytes_in indirilen, bytes_out yüklenen veridir.
gb_limit ölçümden bağımsız
available false olsa bile gb_limit dolu gelebilir; limit veritabanından okunur.
Kullanım geçmişi
GET /orders/{id}/usage-history günlük seri döner. ISP ailesinde requests o gün kapanan bağlantıları, Mobile/Residential'da o günkü istekleri sayar.meta.available false ise bir kaynak okunamamıştır ve eksik günler sıfır kullanım değildir; hiçbir şey okunamazsa 503 service_unavailable döner.