Client API
Il software esterno che detiene la chiave di accesso a questa azienda. Ogni chiamata effettuata viene eseguita con un nome utente specifico di questa azienda, quindi non può accedere a nulla che quell'utente non possa già raggiungere. La chiave viene mostrata una sola volta al momento del rilascio e mai più.
Dove trovarlo
- Modulo: Piattaforma
- Gruppo: Connettività
- Sezione: API pubblicata
- Schermo: Client API
Indirizzo nella console: /platform/api-clients
Lista · 14 colonne · 13 campi sulla sua forma · 3 di loro richiesto · 2 azioni
Cosa mostra l'elenco
Queste sono le colonne dell'elenco, nell'ordine in cui vengono visualizzate. Ognuna di esse può essere utilizzata per ordinare, filtrare, nascondere o esportare i dati.
| Colonna | Tipo | Nome del campo |
|---|---|---|
| Cliente | Codice | code |
| Nome | Testo | name |
| Software | Testo | software_name |
| Protocollo | Stato | protocol |
| Agisce come | Testo | run_as_name |
| Prontezza | Stato | readiness |
| Concesso | Numero | grant_count |
| Indirizzi | Numero | allowlist_count |
| Chiave | Codice | key_last4 |
| Tariffa/minuto | Numero | rate_limit_per_minute |
| Chiamate (24 ore su 24) | Numero | calls_24h |
| Rifiutato (24 ore) | Numero | refused_24h |
| Ultimo utilizzo | Data e ora | last_used_at |
| Stato | Stato | status |
Il modulo
Ecco cosa viene richiesto quando si crea un record. I campi obbligatori sono contrassegnati; una scelta tratta da un elenco di configurazione è una di quelle che un amministratore può estendere senza bisogno di una nuova versione.
| Campo | Tipo | Scelte | Note |
|---|---|---|---|
| Codice client necessario | Testo | ||
| Nome necessario | Testo | ||
| Che software è questo? | Testo | Una chiave sopravvive alla persona che l'ha richiesta. Tra tre anni qualcuno dovrà decidere se è ancora necessaria, e questa sarà la sua scelta. | |
| A chi chiedere informazioni? | Indirizzo e-mail | ||
| Dove vive | Testo | ||
| A cosa serve? | Testo lungo | ||
| Protocollo | Scelta | riposo, mcp, Entrambi | La stessa chiave raggiunge gli stessi dati in entrambi i casi; questo determina quale porta apre. Una chiave MCP presentata all'API REST viene rifiutata per nome, anziché in modo ambiguo. |
| Agisce come necessario | Scelta | Ricercato a partire da record esistenti | Ogni chiamata effettuata con questa chiave viene eseguita a nome di questa persona. Qualunque cosa questa persona non possa fare, la chiave potrebbe non farla, ed è proprio questo che impedisce a un'esposizione di ampliare l'accesso anziché restringerlo. Assegnate un utente creato appositamente per questo scopo, con il ruolo più ristretto che funzioni. |
| Solo da indirizzi consentiti | sì o no | Attivata, e significa proprio questo: una chiave senza indirizzi elencati non raggiunge nulla. Disattivarla è una decisione deliberata, perché significa che questa chiave può essere presentata da qualsiasi parte del mondo da chiunque la possieda. | |
| Limite di frequenza al minuto | Numero | ||
| Cosa dire a un cliente MCP | Testo lungo | Vengono inviate come istruzioni al server quando un agente si connette. Un modello a cui non viene comunicato che questi strumenti raggiungono un registro reale li tratterà come un ambiente di test. | |
| Stato | Scelta | attivo, sospeso, revocato | |
| Scade | Data |
Cosa puoi fare qui
Chiave del problema primario
Emetti una nuova chiave API
Ritira la chiave
Ritira questa chiave
Le regole che si applicano qui
Tutto ciò che appare su questa schermata obbedisce alle regole della piattaforma, non a regole proprie. Ecco quelle che è bene conoscere prima di utilizzarla:
- Restringere un elenco — ricerca, condizioni, ordinamento, totali, esportazione e visualizzazioni salvate.
- Cosa può essere modificato — I cinque motivi per cui un documento non può essere modificato.
- Aziende e unità aziendali — cosa sta facendo lo switcher sopra questo elenco.
- Creazione di un record — Campi obbligatori, provenienza delle opzioni e modalità di assegnazione dei valori.
- Importazione di un foglio di calcolo — Questa schermata ne accetta uno e segue le stesse regole della digitazione.