Abra Settings no avatar e API Key na área pessoal. Cada conta tem uma Key ativa. Gerar novamente invalida a anterior imediatamente; o valor completo aparece uma vez. Envie X-API-Key e Content-Type: application/json em POST. Não exige JWT do site, Cookie, Device-ID, hash ou platform. Bearer não substitui o cabeçalho.
Guarde Key no servidor em variáveis de ambiente ou cofre, nunca em frontend, repositório público ou cliente. Não coloque em URL, corpo, logs ou chamados. Exemplos usam API_KEY. Se vazar, rotacione/desative imediatamente e atualize os consumidores.
400: corrija parâmetros; 401/403: confira Key/conta; 409: resolva conflito; 429: aguarde progressivamente. Consultas podem repetir dentro da quota. Escritas sem chave de idempotência publicada: após timeout/500 verifique aceitação primeiro. App inexistente, versão errada ou falha de envio também podem ser 500 / PUBLIC_API_INTERNAL_ERROR, sem provar que nada executou.
Envie request_id, caminho, HTTP, reason, horário e parâmetros ocultando dados, nunca a Key. Valide consultas primeiro; use dispositivos de teste autorizados para escritas e confira resultados antes de aumentar o lote.