Endpoints

Cada pestaña de tu Google Sheet es un recurso. Si tienes una pestaña llamada Usuarios, tu endpoint es /api/v1/Usuarios. Así de simple.

Si tu hoja no tiene una columna con id el encabezado, SheetCDN usa el número de fila exacto automáticamente a exepción de los encabezados.

Leer — GET

GET /api/v1/{tab}
Parámetro Descripción
limit Cuántas filas traer
offset Desde qué fila empezar
order asc desde el inicio · desc desde el final
GET /api/v1/{tab}?limit=25&offset=0&order=asc

Escribir — POST

POST /api/v1/{tab}
// ------------------------------------------------------------------------
//  ℹ️ Mantén el mismo orden de tus columnas para ambos casos
// ------------------------------------------------------------------------

// JSON — campos nombrados
{ 
   "type": "json", 
   "values": [
       {"campo": "valor"}
    ] 
}

// Array — mismo orden que las columnas de tu sheet
{ 
   "type": "array", 
    "values": ["valor", "valor", "valor"] 
}

Actualizar — PATCH

PATCH /api/v1/{tab}
// Una fila — por id o número de fila exacto
{ "type": "row", "id": "x", "values": {"campo": "valor"} }

// Bulk — el id va dentro de cada objeto
{ "type": "bulk", 
  "values": [
    {"id": "x", "campo": "valor"},
    {"id": "x", "campo": "valor"}
]}

Actualizar — PATCH

PATCH /api/v1/{tab}
// Una fila a la vez — por id o número de fila exacto
{"id": "valor"} / {"#": "valor"}

// Bulk de varias filas en una misma request — el id va dentro de cada objeto
[
    {"id": "x", "campo": "valor"},
    {"id": "x", "campo": "valor"}
    {"id": "x", "campo": "valor"}
]

Eliminar — DELETE

DELETE /api/v1/{tab}/{id}

Usa el id de tu hoja o el número de fila si no tienes columna id.