Saltar al contenido principal

Solución de problemas

La mayoría de los problemas corresponden a un código de estado HTTP. Primero examina la respuesta con curl -i o res.status y después consulta los casos siguientes.

¿Usas un asistente de IA mediante MCP? Consulta la guía de solución de problemas de MCP. Los errores de MCP pueden devolver HTTP 200 con un error JSON-RPC o de herramienta; las indicaciones siguientes son específicas de la API REST.

401 Authentication Failed​

Has activado una clave de API en la conexión, pero la solicitud no la incluye o es incorrecta. Sheet Best utiliza la cabecera X-Api-Key, no Authorization.

curl -H 'X-Api-Key: YOUR_KEY' \
  'https://api.sheetbest.com/sheets/<id>'

Comprueba la clave en Connection → Advanced Settings (Conexión → Configuración avanzada). Consulta claves de API.

402 Payment Required​

Has agotado las solicitudes mensuales de tu plan o la operación no está disponible en él. Comprueba X-RateLimit-Remaining en cualquier respuesta: cuando llega a 0, las solicitudes se bloquean hasta el siguiente ciclo de facturación. El código de error devuelto es throttle.

Amplía tu plan para continuar.

403 Forbidden / write_error​

Las escrituras (POST, PATCH, PUT, DELETE) requieren que Sheet Best tenga acceso de edición a la hoja de Google Sheets. Dos causas habituales:

  • La hoja se comparte como Lector en lugar de Editor (en conexiones con «Cualquier persona con el enlace»).
  • Usas una conexión privada, pero la cuenta autorizada ya no tiene acceso de edición.

Vuelve a compartir la hoja con permiso de edición o reconéctala mediante Connect with Drive.

404 Not Found​

  • El ID de conexión de la URL es incorrecto: vuelve a copiarlo del panel.
  • El nombre de la pestaña está mal escrito: distingue mayúsculas y minúsculas. Consulta pestañas.
  • El índice de fila no existe para esa operación.

405 Method Not Allowed​

El endpoint no acepta ese método. Casos habituales:

  • POST a /search: usa GET con parámetros de consulta.
  • GET a un endpoint de acción que solo acepta escrituras.

Consulta la referencia de códigos de estado HTTP.

Los números se devuelven como cadenas de texto​

Es el comportamiento predeterminado. Añade _raw=1 a cualquier solicitud GET para recibir tipos nativos:

curl 'https://api.sheetbest.com/sheets/<id>?_raw=1'

Consulta formatos de datos.

Array vacío en GET​

  • La hoja tiene cabeceras, pero no filas de datos.
  • Los filtros de la URL no coinciden con nada: prueba el endpoint sin filtros para confirmar que hay filas.
  • Se está consultando la pestaña equivocada: compruébala con /tabs/<TabName>.

Errores CORS en el navegador​

Si has activado una clave de API, llamar a la API directamente desde el navegador la expone. Se recomienda enviar las solicitudes a través de tu propio backend y mantener la clave en el servidor.

¿Sigues teniendo problemas?​