Chiavi API, chiamate API e domande all'assistente AI

L'assistente AI e l'API sono disponibili in tutti i piani, incluso Free. Le rispettive quantità mensili incluse dipendono dal piano e sono condivise da tutta l'organizzazione.

Domande all'assistente AI

L'assistente risponde alle domande sui tuoi dati e sul funzionamento di StockBold. Aprilo dal pulsante Guida in basso a destra nella schermata, poi seleziona Chiedi all'assistente. Ti serve il permesso Use AI Assistant, che è assegnato a tutti i ruoli tranne Operatore.

Ogni domanda a cui l'assistente risponde viene conteggiata una volta nel totale mensile delle domande dell'organizzazione. Una domanda che non va a buon fine a causa di un errore non viene conteggiata.

Quando rimane meno di un quinto delle domande del mese, l'assistente mostra quante ne restano, ad esempio: Ti restano 40 domande su 200 questo mese con il piano Starter. Quando si esauriscono, lo segnala, indica il piano che include più domande e fornisce la data di ripristino del conteggio. Fino a quella data non risponde ad altre domande. Il conteggio compare anche in Impostazioni, poi Piano e fatturazione, sotto Utilizzo.

Quando viene utilizzato l'80% delle domande del mese, i proprietari ricevono un avviso nell'app e via e-mail, se hanno attivato Avvisi su piano e utilizzo in Impostazioni, poi Notifiche.

Creare una chiave API

Una chiave API consente a un altro sistema di leggere e modificare i tuoi dati StockBold tramite l'API. Le chiavi si creano in Impostazioni, poi API, voce visibile al proprietario e a chiunque abbia il permesso Manage API Keys. Il ruolo Amministratore dispone di questo permesso.

1. Apri Impostazioni, poi API.
2. Seleziona Crea chiave API.
3. Inserisci un Nome per poter riconoscere la chiave in seguito.
4. Seleziona i permessi necessari alla chiave. Puoi concedere solo i permessi che possiedi tu stesso.
5. Se vuoi, imposta Scade il. La chiave smette di funzionare alla fine di quel giorno; se lasci il campo vuoto, non scade mai.
6. Se vuoi, elenca gli Indirizzi IP consentiti. Se lasci il campo vuoto, vengono accettate le richieste da qualsiasi indirizzo.
7. Crea la chiave.
8. Copiala subito. Viene mostrata una sola volta.

Gestire le chiavi API

Per ogni chiave nell'elenco puoi modificare i permessi con Modifica permessi, sostituirla con Rigenera o revocarla con Revoca. Quando rigeneri una chiave, quella precedente smette immediatamente di funzionare.

Il proprietario vede anche le chiavi degli altri utenti e può revocarle, oppure disattivare tutte le chiavi dell'organizzazione con Revoca tutte. La scheda Log delle richieste elenca le chiamate effettuate con le chiavi, mentre Documentazione API apre la documentazione di riferimento per chi realizza la connessione.

Il numero di chiavi che l'organizzazione può avere dipende dal piano. Una volta raggiunto il limite, Crea chiave API viene disattivato e sopra l'elenco compare Limite di chiavi API raggiunto.

Chiamate API

Utilizzo API di questo mese, nella stessa pagina, mostra le chiamate effettuate nel mese e quando viene ripristinato il conteggio. Free e Starter includono un numero prestabilito di chiamate al mese; Pro e i piani superiori non hanno un limite mensile.

Ogni piano limita anche il numero di richieste al minuto che l'organizzazione può effettuare complessivamente con tutte le sue chiavi. La pagina mostra questo valore.

Quando le chiamate del mese si esauriscono, le chiamate successive vengono rifiutate fino al ripristino del conteggio. Quando ne viene utilizzato l'80%, i proprietari e la persona che ha creato la chiave ricevono un avviso, se hanno attivato Avvisi su piano e utilizzo.