Clientes de API
O software externo que detém a chave de acesso desta empresa. Cada chamada que ele realiza é executada como um usuário nomeado aqui, portanto, nada que ele possa acessar é algo que esse usuário já não pudesse acessar. A chave é exibida apenas uma vez, no momento em que é emitida, e nunca mais.
Onde encontrar
- Módulo: Plataforma
- Grupo: Conectividade
- Seção: API publicada
- Tela: Clientes de API
Endereço no console: /platform/api-clients
Lista · 14 colunas · 13 campos em seu formulário · 3 deles exigido · 2 ações
O que a lista mostra
Estas são as colunas da lista, na ordem em que são exibidas. Qualquer uma delas pode ser usada para ordenar, filtrar, ocultar ou exportar.
| Coluna | Tipo | Nome do campo |
|---|---|---|
| Cliente | Código | code |
| Nome | Texto | name |
| Software | Texto | software_name |
| Protocolo | Status | protocol |
| Atua como | Texto | run_as_name |
| Prontidão | Status | readiness |
| Garantido | Número | grant_count |
| Endereços | Número | allowlist_count |
| Chave | Código | key_last4 |
| Taxa/min | Número | rate_limit_per_minute |
| Chamadas (24h) | Número | calls_24h |
| Recusado (24h) | Número | refused_24h |
| Último uso | Data e hora | last_used_at |
| Status | Status | status |
O formulário
O que é solicitado aqui quando um registro é criado. Os campos obrigatórios estão marcados; uma opção selecionada de uma lista de configuração é uma que um administrador pode estender sem uma nova autorização.
| Campo | Tipo | Escolhas | Notas |
|---|---|---|---|
| Código do cliente obrigatório | Texto | ||
| Nome obrigatório | Texto | ||
| Que software é esse? | Texto | Uma chave sobrevive à pessoa que a solicitou. Em três anos, alguém terá que decidir se ela ainda é necessária, e essa será a chave que terá como referência. | |
| A quem devo perguntar sobre isso? | Endereço de email | ||
| Onde ele vive | Texto | ||
| Para que serve? | Texto longo | ||
| Protocolo | Escolha | descansar, mcp, ambos | A mesma chave acessa os mesmos dados de qualquer maneira; isso decide qual porta ela abre. Uma chave MCP apresentada à API REST é recusada pelo nome, em vez de de forma confusa. |
| Atua como obrigatório | Escolha | Consultado em registros existentes | Cada chamada feita por essa chave é feita em nome dessa pessoa. Tudo o que ela não puder fazer, a chave também não poderá fazer — e é isso que impede que uma exposição amplie o acesso, em vez de restringi-lo. Atribua a ela um usuário criado especificamente para essa finalidade, com a função mais restrita possível. |
| Somente de endereços autorizados | Sim ou não? | Ligado, e significa isso mesmo: uma chave sem endereços listados não leva a lugar nenhum. Desligá-la é uma decisão deliberada de que essa chave pode ser apresentada de qualquer lugar do mundo por qualquer pessoa que a possua. | |
| Limite de taxa por minuto | Número | ||
| O que dizer a um cliente MCP | Texto longo | Enviadas como instruções do servidor quando um agente se conecta. Um modelo que não é informado de que essas ferramentas acessam um livro-razão ativo as tratará como um ambiente de teste (sandbox). | |
| Status | Escolha | ativo, suspenso, revogado | |
| Expira | Data |
O que você pode fazer aqui
Chave de emissão primário
Emita uma nova chave de API.
Retirar chave
Retire esta chave
As regras que se aplicam aqui
Tudo nesta tela obedece às regras da plataforma, e não a regras próprias. Algumas informações importantes que você precisa saber antes de usar:
- Reduzindo uma lista — Pesquisa, condições, ordenação, totais, exportação e visualizações salvas.
- O que pode ser alterado — Os cinco motivos pelos quais um registro não pode ser editado.
- Empresas e unidades de negócios — O que o seletor acima desta lista está fazendo com ele.
- Criar um registro — campos obrigatórios, de onde vêm as opções e como o número é alocado.
- Importar uma planilha — Esta tela aceita um, e funciona das mesmas regras que a digitação.