Kotalar ve hız limitleri

FreeMaint API, şirket başına bir günlük kota uygular ve UTC gece yarısı sıfırlanır. Sınır seviyenize bağlıdır; sayaçlar ve geri kalanlar yanıt başlıkları olarak gösterilir.

Günlük limitler

• Core, Starter — 0 (API anahtarı için Business gerekir)
• Business — günde 5.000 çağrı (GraphQL ile enerji veri alım uç noktası aynı sayacı paylaşır)
• Enterprise — günde 100.000 çağrı
• On-Premise — sınırsız (limit = null)

Yanıt başlıkları

• X-RateLimit-Limit — seviyenizin günlük sınırı
• X-RateLimit-Remaining — bugün kalan çağrılar (kota sayılan her çağrıda azalma olur)
• X-RateLimit-Reset — Gece yarısı UTC'nin Unix zaman damgası (sonraki sıfırlama)

Ne sayılmaz

Yalnızca /public-api/whoami ücretsizdir: sayacınızı azaltmaz, böylece kota harcamadan bir anahtarı ve planını doğrulayabilirsiniz. /api/v1/graphql üzerinden geçen her şey, whoami sorgusu dâhil, sayılır; enerji veri alım uç noktası da öyle.

Bir çağrı olarak ne sayılır

Sayaç HTTP isteği başına değil, İŞLEM başına artar. Takma adlı 50 mutasyonu tek istekte toplamak yine 50 birim harcar. Toplu göndermek ağ gidiş-dönüşünden tasarruf ettirir, kotadan asla. Yinelenen bir senkronizasyonun ucuz kalması için tüm kataloğu yeniden okumak yerine parts(updatedSince: "...") ile yalnızca değişeni çekin.

Limiti aştığınızda

Günlük sınıra ulaştığınızda sonraki her çağrı «Daily API cap reached» mesajıyla reddedilir. REST yüzeylerinde (/public-api/ping, enerji veri alım uç noktası) bu bir HTTP 403'tür. GraphQL'de HTTP durumu 200'dür ve ret errors[0].extensions.code = FORBIDDEN içinde, originalError.statusCode = 403 ile birlikte bulunur. Sayaç 00:00 UTC'de sıfırlanır. Esnek sınır, ani yük payı veya dakikalık pencere yoktur — pencere bir gündür.