Automação

API da plataforma

A API pública usa a base https://api.devoracloud.com/v1. Crie uma chave em Ferramentas da conta → API e envie Authorization: Bearer SUA_CHAVE. A chave pertence a uma única organização, dá acesso somente a ela e respeita as permissões atribuídas. Uma chave não cria outra chave: POST /v1/api-keys feito com uma chave responde 403 FORBIDDEN, e só uma pessoa logada cria chaves, pelo painel. Não coloque a chave no código público de um site nem a envie ao navegador dos visitantes.

GET /projects lista projetos. GET /projects/:id consulta um projeto. GET /projects/:id/metrics consulta as métricas disponíveis. POST /projects/:id/scale, com um corpo JSON como {"replicas":2}, solicita a quantidade desejada de cópias. A solicitação respeita o teto de réplicas, a capacidade do plano e as permissões da chave. O máximo é o teto do plano (Hobby 2, Pro 3, Enterprise 5 cópias ligadas; o failover em espera vem incluso e fica desligado). Cópias além da principal são cobradas por hora e exigem plano pago em dia; no teste ou com fatura em aberto, a API responde 402.

Respostas bem-sucedidas usam {data, meta}; falhas usam {error:{code,message,details}}. PLAN_LIMIT_EXCEEDED (HTTP 402) indica que a operação precisa de um plano maior ou de uma redução nos recursos reservados; details traz resource, limit e used. Com resource "subscription", o teste terminou ou há fatura em aberto. Não repita alterações automaticamente ao receber esse erro: confira a mensagem e os limites.