Autenticação

Autentique com API keys Bearer (dcs_live_ e dcs_test_) — crie, guarde, troque e revogue as chaves — e saiba onde elas funcionam.

Toda chamada à API pública precisa de uma API key no header Authorization:

Authorization: Bearer dcs_live_9fK2mQ7xLp4Rt8Vw1Zc6Nb3Hy5Js0Ad2

Uma chave é dcs_live_ ou dcs_test_ seguido de 32 letras e dígitos. Header ausente, esquema diferente de Bearer, chave malformada, desconhecida ou revogada — todos falham com:

401 Unauthorized
{
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Missing, invalid or revoked API key.",
    "request_id": "req_Qm8vT2kLx9Pw4Rz7Nc1B"
  }
}

Crie uma chave

  1. No app, abra API Keys e clique em Nova chave.
  2. Dê um nome a ela (por exemplo, o serviço que vai usá-la) e escolha o ambiente: Live (dcs_live_…) ou Test (dcs_test_…).
  3. Clique em Criar chave e copie-a. A chave completa aparece só uma vez.

Guarde-a no seu gerenciador de segredos ou numa variável de ambiente como DCISION_API_KEY. A Dcision guarda só um hash SHA-256 da chave, então uma chave perdida não pode ser recuperada — crie uma nova.

A lista de chaves mostra o nome de cada chave, uma forma mascarada (dcs_live_9fK2…0Ad2), o ambiente, quando foi criada e quando foi usada pela última vez (atualizado no máximo uma vez por minuto). Membros, Admins e o Proprietário podem criar, renomear e revogar chaves; Leitores só veem a lista — veja Time, papéis e conta. Um workspace pode ter até 50 chaves ativas.

Chaves live e test

Os dois ambientes se comportam igual: chamam as mesmas versões publicadas, compartilham o rate limit do workspace e são cobrados da mesma forma. A diferença é organizacional — use chaves de teste em staging, CI e desenvolvimento local para poder revogá-las sem mexer na produção — mais uma flag: as entregas de destinos de chamadas feitas com uma chave de teste levam livemode: false, para que os receptores possam mantê-las fora da produção.

Escopo

  • Uma chave pertence a um workspace e pode chamar todas as decisões desse workspace, além de ler as decisões, a conta e as execuções dele com GET /v1/decisions, GET /v1/me e GET /v1/executions. A mesma chave autentica o servidor MCP.
  • Uma chave de outro workspace não alcança as suas decisões: ela recebe 404 DECISION_NOT_FOUND, e o /v1/executions dela só lista as execuções do próprio workspace.
  • As chaves só funcionam na API pública (/v1/…). Os endpoints do app as recusam com 403 FORBIDDEN — "API keys can only call the /v1 decision endpoints."

Verifique uma chave

GET /v1/me responde 200 com o workspace, o nome, o ambiente e o plano da chave, ou 401 INVALID_API_KEY. É uma checagem barata para scripts de CI e de deploy — não roda nenhuma decisão e não é cobrada:

curl -sf https://api.dcision.io/v1/me -H "Authorization: Bearer $DCISION_API_KEY" > /dev/null \
  && echo "key OK" || echo "key rejected"

Troque uma chave

  1. Crie uma chave nova.
  2. Faça o deploy da sua aplicação com a chave nova.
  3. Revogue a chave antiga quando o Último uso dela parar de mudar.

Revogue uma chave

Revogar vale na hora e não dá para desfazer: toda requisição com a chave falha com 401 INVALID_API_KEY. As chaves revogadas continuam na lista, em cinza, para referência.

Mantenha as chaves seguras

  • Chame a API a partir do seu servidor, nunca de um navegador, de um app mobile ou de um bundle de cliente.
  • Nunca faça commit de chaves num repositório; carregue-as do ambiente.
  • Use uma chave por serviço, para poder revogar uma sem afetar as outras.

Nesta página