Vai al contenuto principale

Limitazione per l'utilizzo dell'API REST

tado° avatar
Scritto da tado°
Aggiornato oltre 2 settimane fa

Per garantire la stabilità a lungo termine continuando a consentire l'accesso alla nostra API REST, abbiamo implementato i seguenti limiti:

  • 100 richieste al giorno

    Ciò dovrebbe comunque supportare i casi d'uso di base che non sono disponibili tramite le API locali di tado°: HomeKit per dispositivi V3/V3+ o Matter per dispositivi tado° X.

  • Per gli abbonati all’Auto-Assist ed AI Assist: 20.000 richieste al giorno

    Ciò dovrebbe coprire anche i casi d'uso più impegnativi e le quote di abbonamento ci consentono di compensare i costi maggiori associati alle chiamate aggiuntive al server.

Se ha riscontrato problemi di recente, è probabile che il suo account abbia raggiunto il limite giornaliero di 20.000 o 100. Per scoprire quante richieste le restano, può controllare l'intestazione ”ratelimit” (limite di tariffa). Apparirà come segue:

  • ratelimit: "perday";r=123 ciò significa che restano 123 richieste ("perday” significa "al giorno” e ”r=” indica il numero di richieste rimaste).

oppure

  • ratelimit: "perday";r=0;t=123, ciò significa che ha raggiunto il limite ('r=0' significa zero richieste rimaste) e tra 123 secondi il limite di tariffa verrà ricaricato ('t=' indica il numero di secondi che mancano al ripristino del limite di tariffa).

Sebbene non sia mai stata ufficialmente supportata da terze parti, in passato abbiamo lasciato la nostra API REST aperta e senza restrizioni.

Crediamo nel fair use o utilizzo corretto e intendiamo continuare a sostenere questo principio. Il nostro coinvolgimento nell'implementazione di questa limitazione è un'esigenza eccezionale, poiché abbiamo riscontrato che una piccola frazione di utenti API molto frequenti ha generato una quota sproporzionatamente elevata delle nostre spese per i server.

Hai ricevuto la risposta alla tua domanda?