Skip to main content
Todas as rotas /v1/* exigem autenticacao via Bearer token no header Authorization.

​
Formato do token

Os tokens da API Mycroft usam o prefixo myc_ para facilitar identificacao e rotacao: 
Authorization: Bearer myc_xxxxxxxxxxxxx

​
Gerar API key

1

Acessar o dashboard

Faca login no dashboard Mycroft com suas credenciais.
2

Navegar ate API Keys

No menu lateral, acesse Configuracoes e depois API Keys.
3

Gerar nova chave

Clique em Gerar nova chave, de um nome descritivo e copie o token gerado.
A chave e exibida apenas uma vez. Apos a geracao, o servidor armazena apenas o hash SHA-256 do token. Se perder a chave, gere uma nova.

​
Exemplo de request autenticado

curl -X GET https://api-mycroft.sherlocker.com.br/api/v1/engines \
  -H "Authorization: Bearer myc_sua_chave_aqui"

​
Erros de autenticacao

Requisicoes sem token ou com token invalido recebem resposta 401 Unauthorized no formato ProblemDetail (RFC 7807): 
{
  "type": "https://mycroft.app/problems/unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Token de autenticacao ausente ou invalido"
}