SDK in abbonamento
OAuth per utente · limiti del piano condivisi tra le app · modello gestito da Pura.
Cerchi le API a consumo?Abbonamenti e limiti
Consumo percentuale, quattro sessioni e cambio dinamico.
Piani e rinnovo
Per inviare richieste è necessario un abbonamento attivo e pagato. L’utente sceglie e gestisce il piano nella console Pura, dove trova prezzi, stato e data di rinnovo. La registrazione di un’app o il consenso OAuth non attivano un abbonamento.
Quattro sessioni da sette giorni
Le sessioni sono ancorate all’inizio del periodo pagato. Ogni sessione vale il 25% dell’utilizzo mensile incluso; i limiti mensile e settimanale sono indipendenti. Dal giorno 28 al rinnovo resta soltanto il residuo della quarta sessione. Nessuna quinta sessione e nessun riporto dei residui delle precedenti.
Contratto percentuale
GET /v1/integrations/usage richiede usage:read. Leggi monthly_used_percent, monthly_remaining_percent, weekly_used_percent, weekly_remaining_percent e blocked_reason. I limiti di ciascun ambito valgono 100%; weekly_share_percent vale 25%. Le percentuali possono essere stringhe decimali: non confrontarle come stringhe.
{
"monthly_used_percent": "12.500000",
"monthly_remaining_percent": "87.500000",
"monthly_limit_percent": "100.000000",
"weekly_used_percent": "50.000000",
"weekly_remaining_percent": "50.000000",
"weekly_limit_percent": "100.000000",
"weekly_share_percent": "25.000000",
"weekly_session": 1,
"blocked_reason": null
}Reset, blocco e tolleranza
Usa weekly_reset_at e period_end restituiti dal server, senza calcolare sette giorni dalla tua ultima richiesta. Con un blocco settimanale attendi il reset, con un blocco mensile il rinnovo. Le richieste già in corso possono portare used_percent oltre 100%; il residuo esposto non diventa negativo.
Stati e notifiche
past_due, canceled e unpaid impediscono nuove inferenze. Una cancellazione a fine periodo mantiene il periodo già pagato fino alla sua scadenza se lo stato resta active. Pura notifica le soglie 80% e 100% dell’ambito corrente; le notifiche non contengono importi di budget.