Cote și limite de viteză

FreeMaint API impune o cotă zilnică per companie, resetata la miezul nopții UTC. Capacul depinde de nivelul dvs.; contoarele și restul sunt expuse ca antete de răspuns.

capace zilnice

• Core, Starter — 0 (o cheie API necesită Business)
• Business — 5.000 de apeluri/zi (GraphQL și endpointul de preluare a datelor de energie folosesc același contor)
• Enterprise — 100.000 de apeluri/zi
• On-Premise — nelimitat (limită = null)

Antete de răspuns

• X-RateLimit-Limit — plafonul zilnic al nivelului dvs.
• X-RateLimit-Remaining — apeluri rămase astăzi (scăderi la fiecare apel numărat în cotă)
• X-RateLimit-Reset — Marcaj temporal Unix pentru miezul nopții UTC (următoarea resetare)

Ce nu conteaza

Doar /public-api/whoami este gratuit: nu îți scade contorul, așa că poți verifica o cheie și planul ei fără să consumi cotă. Tot ce trece prin /api/v1/graphql se contorizează, inclusiv interogarea whoami, la fel și endpointul de preluare a datelor de energie.

Ce se contorizează drept un apel

Contorul crește pentru fiecare OPERAȚIE, nu pentru fiecare cerere HTTP. Gruparea a 50 de mutații cu alias într-o singură cerere consumă tot 50 de unități. Gruparea economisește deci drumuri de rețea, niciodată cotă. Ca o sincronizare recurentă să rămână ieftină, luați doar ce s-a schimbat cu parts(updatedSince: "...") în loc să recitiți întregul catalog.

Când depășiți plafonul

Odată atins plafonul zilnic, fiecare apel suplimentar este refuzat cu mesajul „Daily API cap reached”. Pe suprafețele REST (/public-api/ping, endpointul de preluare a datelor de energie) acesta este un HTTP 403. Pe GraphQL statusul HTTP este 200, iar refuzul se află în errors[0].extensions.code = FORBIDDEN, cu originalError.statusCode = 403. Contorul se resetează la 00:00 UTC. Nu există plafon flexibil, rezervă pentru vârfuri sau fereastră pe minut — fereastra este ziua.