Autenticação com API key

Quase toda rota da delegacia exige um distintivo: uma chave que identifica você.

1. Crie o distintivo (uma vez só):

curl -X POST https://api-murder.rafaeltoshiba.com.br/api/v1/detectives \
  -H "Content-Type: application/json" \
  -d '{"name": "Ana"}'

A resposta traz detective_key, algo como dk_7f3a.... Guarde. A delegacia não emite segunda via.

2. Guarde a chave numa variável, pra não redigitar:

DK="dk_cole_sua_chave_aqui"          # bash / Git Bash / macOS / Linux

$env:DK = "dk_cole_sua_chave_aqui"   # PowerShell

3. Mande a chave no header X-Detective-Key em toda requisição:

curl https://api-murder.rafaeltoshiba.com.br/api/v1/cases -H "X-Detective-Key: $DK"

curl.exe https://api-murder.rafaeltoshiba.com.br/api/v1/cases -H "X-Detective-Key: $env:DK"

Erros que você pode ver:

• 401 missing_detective_key: o header não foi enviado.
• 401 invalid_detective_key: a chave não existe. Confira se copiou inteira.

Isso é uma API key: um segredo fixo que vai num header. Mais adiante você vai conhecer o Bearer token, que expira.