Limiti di frequenza e quote

Chiamate al minuto, clip in contemporanea, chiamate non riuscite al giorno e quote al mese, per organizzazione: tutte le sue chiavi insieme, secondo il tuo piano. Le chiamate senza chiave contano per indirizzo.

Chiamate al minuto

Ogni chiamata autenticata conta per il limite della sua organizzazione, tutte le sue chiavi insieme, che si tratti di marcature, marche temporali o utilizzo. Le finestre sono minuti interi dell’orologio (UTC), quindi il conteggio riparte all’inizio di ogni minuto. Ogni risposta indica a che punto sei:

X-RateLimit-Limit: 10          # calls this minute, for this organisation
X-RateLimit-Remaining: 7       # left this minute
X-RateLimit-Reset: 1792663260  # Unix time (s) when the minute ends

Oltre il limite l’API risponde 429 rate_limited con Retry-After in secondi. Distribuisci il lavoro nell’arco del minuto, oppure passa a un piano più grande. Gli SDK per JavaScript e Python attendono da soli un Retry-After fino a un minuto.

Chiamate non riuscite

Una marcatura o un controllo che fallisce dopo che ci abbiamo lavorato (mark_failed, o un controllo che il servizio di controllo non è riuscito a completare) non conta nulla, quindi questi errori hanno un tetto giornaliero per organizzazione: Free 100, Indie 300, Startup 1.000, Scale 3.000 al giorno (UTC). Oltre questo tetto, POST /v1/mark e POST /v1/check rispondono 429 fino alle 00:00 UTC. I rifiuti prima di qualsiasi lavoro (un file che non riusciamo a leggere, un blocco, marcature residue insufficienti) non contano.

Clip

Una clip viene marcata come job, e ogni piano ne marca alcune in contemporanea (Free 1, Indie 2, Startup 3, Scale 5). Una clip inviata mentre sono tutte in elaborazione riceve 429 rate_limited con Retry-After: 30.

Una clip che fallisce dopo che ci abbiamo lavorato (la sua filigrana non si rilegge, o non si riesce a marcarla in tempo: mark_failed) non conta nulla, quindi questi errori hanno un tetto giornaliero: Free 3, Indie 10, Startup 10, Scale 20 in 24 ore. Oltre questo tetto, le nuove clip ricevono 429 finché non sono passate 24 ore dal primo di quegli errori. GET /v1/marks/{id} indica perché ciascuna è fallita. I rifiuti prima di qualsiasi lavoro (una clip oltre i nostri limiti, un blocco, marcature residue insufficienti) non contano.

Chiamate senza chiave

Gli endpoint pubblici contano invece per indirizzo, con gli stessi header. Un indirizzo IPv6 conta per il suo /64, il blocco che di solito viene assegnato a una connessione.

• POST /v1/verify: 10 file al minuto e 200 al giorno. Senza chiave, inoltre, l’intero servizio risponde al massimo a 5.000 verifiche al giorno (UTC), e a 500 con signed=true; con una chiave (gratuita), le verifiche contano invece per le chiamate al minuto della tua organizzazione. La pagina del verificatore legge i file nel tuo browser e qui non conta.
• Il registro di trasparenza, GET /v1/credentials e GET /v1/verify/key: 120 chiamate al minuto.

Quote mensili

• Marcature: una per ogni chiamata POST /v1/mark riuscita, e due per ogni immagine letta dal controllo di sicurezza (POST /v1/check, o check su una marcatura). Le chiavi di test hanno una propria quota: 100 marcature al mese nel piano Free, quante quelle di produzione nei piani a pagamento. Le 1.000 marcature del piano Free sono un’unica quota per persona: le riceve la sua prima organizzazione, e ogni altra organizzazione che crea parte senza marcature finché non ha un piano a pagamento.
• Dati restituiti: i byte dei file marcati che ti restituiamo in modalità cloud (1 GB = 10⁹ byte).
• Marche temporali: una per ogni POST /v1/tsa, fino al numero di marcature del tuo piano, anche qui con produzione e test separati.

Le quote seguono il mese solare in UTC. Quando una è esaurita, l’API risponde 402 quota_exceeded fino al primo del mese successivo o finché non passi a un piano superiore. Una marcatura viene riservata quando una richiesta è accettata, e riaccreditata se qualcosa non va a buon fine, quindi contano solo le marcature consegnate. I tuoi numeri attuali sono nella dashboard, negli header X-Marks-Used e X-Marks-Limit, e su GET /v1/usage.

I piani mensili a pagamento continuano oltre la quota ai prezzi pubblicati per gli extra, fatturati il primo del mese, fino a dieci volte la quota; i piani annuali si fermano alla quota, come Free.