Erros
A API do Spaace usa códigos de status HTTP convencionais para indicar sucesso ou falha. Este guia detalha os erros mais comuns e como tratá-los.
Códigos de status
| Código | Descrição |
|---|---|
| 200 | Sucesso |
| 400 | Requisição malformada — verifique os parâmetros |
| 401 | Não autenticado — API key inválida ou ausente |
| 403 | Sem permissão para acessar este recurso |
| 404 | Recurso não encontrado |
| 429 | Rate limit excedido — aguarde antes de tentar novamente |
| 500 | Erro interno do servidor |
Formato do erro
Todos os erros retornam um body JSON com a mesma estrutura:
JSON
{
"error": {
"code": "rate_limit_exceeded",
"message": "Muitas requisições. Tente novamente em 30s.",
"retry_after": 30
}
}Rate Limiting
A API limita requisições por workspace. Os headers de resposta incluem informações sobre o limite:
X-RateLimit-Limit— máximo de requisições por minutoX-RateLimit-Remaining— requisições restantesX-RateLimit-Reset— timestamp UTC de reset do limite