Códigos de estado HTTP
Sheet Best es una API RESTful y utiliza códigos HTTP estándar para indicar éxito o fallo. Los códigos del rango 4xx indican un problema con la solicitud; los del rango 5xx indican un problema de Sheet Best y son poco frecuentes.
| Estado | Descripción |
|---|---|
200 OK | Todo funcionó como se esperaba. |
400 Bad Request | La solicitud no es válida, a menudo por un parámetro ausente o permisos insuficientes sobre la hoja. |
401 Authentication Failed | Credenciales de autenticación incorrectas. Consulta claves de API. |
402 Payment Required | La operación no está permitida en tu plan o has agotado las solicitudes mensuales. Comprueba X-RateLimit-Remaining. |
403 Forbidden | No tienes permiso para realizar esta acción. |
404 Not Found | El recurso solicitado no existe. Comprueba el ID de conexión, el nombre de la pestaña o el índice de fila. |
405 Method Not Allowed | El endpoint no admite ese método HTTP (por ejemplo, POST en el endpoint /search). |
500 / 502 / 503 / 504 | Errores del servidor de Sheet Best. |
Algunas respuestas 4xx también incluyen un código de error de texto que puedes evaluar.
Consultar el estado
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}`);
}