API keys

Uma API key deixa um script chamar o Mockzilla como a sua organização. As keys ficam nas Configurações, na aba API keys. Owners e admins cuidam delas.

Cada linha mostra o papel da key, quando ela foi criada e quando foi usada pela última vez. Prefixo são os primeiros 12 caracteres da key, que é a única parte que a gente guarda.

Criar uma key

Aperte Criar key, dê um nome e escolha um papel.

• Editor lê e muda simulações.
• Viewer lê.

Uma key nunca gerencia membros, outras keys nem a cobrança, seja quem for que criou ela.

A key em si aparece uma vez só, logo depois de você criar. Copie ali e guarde em um lugar seguro. A gente guarda só um hash dela, então uma key perdida é uma key nova.

Veja Papéis e permissões.

Usar uma key

Mande ela como bearer token:

curl "https://platform.mockzilla.org/v1/sims/" \
  -H "Authorization: Bearer mz_live_..."

A key pertence a uma organização e enxerga as simulações daquela organização, seja quem for que criou e seja o que for que essa pessoa acessa em outro lugar.

O que uma key faz é registrado com o nome da key, então um deploy vindo do CI não é arquivado como o clique de alguém.

Veja Log de auditoria.

Revogar uma key

Revogar na linha para a key na hora. Tudo que ainda estiver usando ela começa a falhar na chamada seguinte.

A linha fica, marcada com a data. O filtro acima da tabela troca entre keys ativas, keys revogadas e todas.

Quantas você pode ter

O seu plano define quantas keys ativas uma organização pode ter. O diálogo de criação avisa quando você chegou no teto, e revogar uma libera um lugar.

Os agentes que você conecta por MCP recebem as credenciais deles. Eles não estão nesta lista e não contam nesse número.

Veja Servidor MCP.