Códigos de status HTTP
O Sheet Best é uma API RESTful e usa códigos HTTP padrão para indicar sucesso ou falha. Os códigos na faixa 4xx indicam um problema na requisição; os da faixa 5xx indicam um problema no Sheet Best e são raros.
| Status | Descrição |
|---|---|
200 OK | Tudo funcionou como esperado. |
400 Bad Request | A requisição não é válida, geralmente por um parâmetro ausente ou permissão insuficiente na planilha. |
401 Authentication Failed | Credenciais de autenticação incorretas. Consulte chaves de API. |
402 Payment Required | A operação não é permitida no plano ou você usou todas as requisições mensais. Verifique X-RateLimit-Remaining. |
403 Forbidden | Você não tem permissão para executar esta ação. |
404 Not Found | O recurso solicitado não existe. Verifique o ID da conexão, o nome da aba ou o índice da linha. |
405 Method Not Allowed | O endpoint não aceita esse método HTTP (por exemplo, POST no endpoint /search). |
500 / 502 / 503 / 504 | Erros do servidor do Sheet Best. |
Algumas respostas 4xx também incluem um código de erro em texto que você pode avaliar.
Consultar o status
curl -i 'https://api.sheetbest.com/sheets/<id>'
const res = await fetch('https://api.sheetbest.com/sheets/<id>');
if (!res.ok) {
console.error(`Request failed: ${res.status}`);
}