Abrir o NoteBugs

Integração

Códigos de status

Todos os códigos que a API emite, e quando.

Código	Quando
`200`	leitura, edição, remoção e as respostas de contagem (`{ updated: 2 }`)
`201`	criação: card, comentário, anexo, vínculo, projeto, epic, etiqueta, modelo, coluna, espaço, conta e a primeira conta da instalação
`400`	corpo não é JSON válido; ou multipart com `file` e `remote` juntos
`401`	sem credencial, credencial vencida, senha atual errada, e-mail ou senha inválidos
`403`	papel insuficiente; espaço fora do alcance; feature desligada (epics, colunas, upload, criação de espaços); modo demonstração
`404`	o recurso não existe ou já foi apagado
`409`	nome duplicado; a instalação já tem conta (setup); backup em curso; `.zip` fora de `READY`; bucket que não guarda backups; vínculo que já existe; configuração de armazenamento bloqueada
`413`	arquivo maior que o limite por anexo
`415`	formato não aceito, julgado pelos magic bytes e não pela extensão
`422`	corpo fora do schema (com `details`) ou regra de negócio recusada (sem `details`)
`429`	limite de requisições excedido; a resposta traz `Retry-After` em segundos
`500`	falha não tratada. `EACCES`/`EPERM` no volume vêm com o caminho na mensagem, e não como 500 genérico
`502`	o bucket recusou ou não respondeu; a mensagem traz o que o S3 devolveu

Nunca 200 com erro dentro

A única rota que responde 200 para um estado que parece falha é /api/auth/session: “não há ninguém” é uma resposta, e não um erro. Todo o resto usa o código HTTP.