A API usa códigos de status HTTP convencionais. Abaixo, todos os códigos que aparecem nos
endpoints públicos, com o significado e onde cada um é emitido.
Sucesso · 2xx
Código
Significado
Onde aparece
200
OK. Requisição bem-sucedida; o corpo traz o recurso, o array ou o envelope.
Todos os endpoints públicos em caso de sucesso.
Erros do cliente · 4xx
Código
Significado
Onde aparece
400
Bad Request. A requisição é inválida: parâmetro fora do formato, corpo malformado ou regra de validação não atendida.
Entrega de anúncio (formato inválido), entrega em lote (slots inválidos), busca (q < 3 caracteres), clique (clickToken inválido/expirado).
401
Unauthorized. Chave de API ausente ou inválida no header X-API-Key.
Todos os endpoints públicos (todos exigem chave).
403
Forbidden. A origem (Origin/Referer) não está autorizada para o blog.
Apenas no clique de anúncio (POST /public/ads/tracking/click).
404
Not Found. Recurso inexistente ou não publicado para o identificador informado.
Post por ID/slug, categoria por ID, tag por ID.
409
Conflict. O clickToken já foi utilizado (uso único).
Apenas no clique de anúncio (POST /public/ads/tracking/click).
Erros do servidor · 5xx
Código
Significado
Onde aparece
500
Internal Server Error. Falha inesperada no servidor.
Não declarado explicitamente nos endpoints públicos da especificação, mas, como em qualquer API, pode ocorrer. Trate com retentativa e backoff.