Guida introduttiva

Segui la Guida all’Autenticazione per accedere, therefore apri la pagina Chiavi di gestione e crea una chiave di gestione. Conservala separatamente dalle chiavi dell’applicazione standard. Inviala come token bearer solo agli endpoint di Gestione della Piattaforma.

Una chiave API standard non può chiamare gli endpoint di gestione di chiavi o guardrail. Una chiave di gestione valida può comunque ricevere 403 Forbidden quando il suo proprietario non dispone più del ruolo account richiesto.

Usa GET /api/v1/keys per esaminare le chiavi visibili all’account della chiave di gestione:

Usa gli identificatori pubblici restituiti per successive richieste di recupero, aggiornamento, revoca o assegnazione di guardrail. Non dedurre mai l’accesso dal nome di una chiave o da un token mascherato.

Crea una chiave applicativa con POST /api/v1/keys. Il secret completo viene restituito solo nella risposta di creazione, quindi salvalo nel tuo gestore di secret prima di scartare quella risposta. La rotazione deve creare una sostituzione, distribuirla nell’applicazione, verificare il traffico e quindi revocare la vecchia chiave.

credit_limit_windows accetta qualsiasi combinazione di limiti di spesa progressivi 1h, 1d e 7d. Se una finestra temporale configurata viene esaurita, le chiamate con quella chiave restituiscono 429 Too Many Requests fino a quando l’utilizzo non esce dalla finestra temporale. Invia un oggetto vuoto quando aggiorni una chiave per eliminare tutti i limiti di spesa progressivi.

I Guardrail sono policy di account riutilizzabili per i controlli su modello, provider e spesa. Gestisci le policy tramite /api/v1/guardrails, quindi utilizza /api/v1/guardrail_assignments per associarle o rimuoverle. Considera un’assegnazione rifiutata come un errore di policy o di proprietà anziché continuare silenziosamente senza il guardrail.