📝 Checklists — API de Solved

Endpoint

GET /checklists
https://europe-west1-try-solved.cloudfunctions.net/api/checklists

Autenticación

La API utiliza Bearer Token de Firebase Authentication.

Authorization: Bearer <token>
Content-Type: application/json

El token se obtiene iniciando sesión con Firebase usando las credenciales de tu cuenta de Solved.

Parámetros de consulta

Parámetro

Tipo

Obligatorio

Descripción

Estados válidos

uncomplete, planned, closedOk, closedKo, closedWithWarning,
closedUncomplete, correctionApplied, pendingForVerification

Lógica inteligente de fechas

La API aplica automáticamente el filtro de fechas al campo correcto:

• planned → plannedDate

• uncomplete → creationDate

• cerrados / verificados → executionDate

• sin estado → busca coincidencia en los tres campos

Esto evita errores comunes al cruzar estados con fechas.

Ejemplo de petición

GET /checklists?startDate=2026-01-01T00:00:00Z&endDate=2026-02-01T00:00:00Z&status=closedOk&pageSize=10

Respuestas

200 — Resultados encontrados

Incluye checklists completos con secciones y controles.

{
  "checklists": [...],
  "total": 142,
  "page": 0,
  "pageSize": 10,
  "hasMore": true
}

200 — Sin resultados

{
  "checklists": [],
  "total": 0,
  "hasMore": false
}

Errores comunes

• 400 → parámetros faltantes o inválidos

• 401 → token no proporcionado o inválido

Modelo de datos

Checklist

Incluye metadatos, fechas, usuarios, categorías y secciones.

Campos clave:

• refId

• status

• creationDate / executionDate / plannedDate

• owner, verifier, executors

• sections

Los checklists planned son virtuales: muestran la estructura de la plantilla sin datos rellenados.

Section

Cada checklist contiene secciones con su propio estado y controles.

Control

Representa cada campo rellenado por el usuario:

• Tipos: Text, Select, Date, User, Media, etc.

• Soporta correcciones, comentarios y adjuntos

Paginación

La API devuelve información completa para recorrer grandes volúmenes:

• total

• page

• pageSize

• hasMore

Ejemplo:

GET /checklists?...&page=1&pageSize=50

Ejemplos de uso

Autenticación Firebase (Python)

def get_firebase_token(email, password):
    ...

Consulta básica (Python)

response = requests.get(
  f"{BASE_URL}/checklists",
  headers=headers,
  params={...}
)

Descarga completa con paginación

Ideal para exports o sincronizaciones.

while hasMore:
   ...

JavaScript (Fetch)

const response = await fetch(`${BASE_URL}/checklists?...`);

Exportar a CSV (JavaScript)

Genera una fila por control, perfecta para Excel o BI.

const rows = [["RefId", "Checklist", "Estado", ...]];

Casos de uso típicos

• Reporting y KPIs externos

• Exportaciones para auditorías

• Integraciones con ERP / BI

• Automatizaciones y análisis histórico