Vai al contenuto principale
POST
Imposta la configurazione dell'utilizzo

Panoramica

Imposta o rimuovi i limiti di utilizzo per utente sui crediti aggiuntivi della tua organizzazione. I limiti vengono sempre applicati per singolo utente. Quando specifichi un ambito relativo a un team o gruppo, il limite viene applicato singolarmente a ciascun utente all’interno di quel team o gruppo; non imposta un limite condiviso per l’intero team o gruppo.

Richiesta

service_key
string
obbligatorio
La tua chiave di servizio con l’autorizzazione “Billing Write”

Configurazione del limite di credito (scegline una)

clear_add_on_credit_cap
boolean
Imposta su true per azzerare il limite di credito aggiuntivo esistente
set_add_on_credit_cap
integer
Imposta un nuovo limite di credito aggiuntivo (valore intero)
Devi specificare clear_add_on_credit_cap oppure set_add_on_credit_cap, ma non entrambi.

Configurazione dell’ambito (Scegline una)

team_level
boolean
Imposta su true per applicare il limite per utente a tutti gli utenti del team
group_id
string
Applica il limite per utente a tutti gli utenti di un gruppo specifico fornendo l’ID del gruppo
user_email
string
Applica la configurazione a un utente specifico fornendo il suo indirizzo email
Devi fornire uno tra team_level, group_id o user_email per definire l’ambito.

Esempio di richiesta - Imposta un limite di credito per utente per tutti gli utenti del team

Esempio di richiesta - Imposta il limite di credito per ciascun utente per tutti gli utenti di un gruppo

Esempio di richiesta - Impostare il limite di credito per un utente

Esempio di richiesta - Rimozione del limite di credito

Risposta

Il corpo della risposta è vuoto. Un codice di stato 200 indica che l’operazione è andata a buon fine.

Risposte di errore

Scenari di errore comuni:
  • Chiave di servizio non valida o autorizzazioni insufficienti
  • Sono stati forniti sia clear_add_on_credit_cap sia set_add_on_credit_cap
  • Non è stato fornito né clear_add_on_credit_capset_add_on_credit_cap
  • Sono stati forniti più parametri di ambito
  • Non è stato fornito alcun parametro di ambito
  • ID del gruppo o email dell’utente non validi
  • Limite di richieste superato