Saltar al contenido
Fipeo

Fipeo para desarrolladores

Registro de cambios

Acceso anticipado. La API, los webhooks y el widget están apagados para la mayoría de las cuentas mientras los probamos con las primeras escuelas y agencias. Esta documentación es pública para que puedas planear tu integración: escríbenos a [email protected] y te lo encendemos.

La API está en acceso anticipado. Antes del lanzamiento cerramos la v1: todo lo de abajo es la v1 tal como es hoy, así que no hay nada que migrar. A partir de ahora, dentro de v1 solo añadimos cosas (rutas, campos, eventos, estados y códigos de error) y tu cliente tiene que ignorar los campos que no conozca. Un cambio incompatible iría a /v2, anunciado aquí con antelación.

Noviembre de 2026 — v1, antes del lanzamiento

  • Claves de API con permisos y OAuth 2.0 client credentials (POST /oauth/token, POST /oauth/revoke).
  • Rutas: /me, /schools, /courses, /quotes, /bookings, /students (leer y crear). students y quotes contestan 403 dpa_required mientras el acuerdo de encargo sea obligatorio y no esté aceptado.
  • Códigos estables en inglés para todos los estados: reservas new, pending, alternative_proposed, accepted, declined, cancelled, expired; modality de la bandeja on_request o instant. Igual en los webhooks.
  • Fechas con hora en ISO 8601 y UTC (2026-11-11T10:00:00Z) en toda la API, en las respuestas y en los webhooks. Las fechas siguen como YYYY-MM-DD.
  • En las reservas, school es el mismo objeto en la lista y en el detalle: { id, name }.
  • Todas las listas aceptan page y contestan items, total, page, pages y next: nada se corta en silencio.
  • Un filtro inválido (status, page…) contesta 422 con clave de agencia o de escuela. Una ruta que no existe contesta 404 not_found; un método que no vale, 405 method_not_allowed.
  • RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset y RateLimit-Policy en cada respuesta a una clave, además de Retry-After en el 429.
  • Idempotency-Key en POST /students: la misma petición con la misma clave da la misma respuesta durante 24 horas.
  • Webhooks firmados (booking.created, booking.status_changed, quote.accepted, student.created, message.created, ping) con reintentos, registro de entregas y reenvío; automation.run para la acción «webhook» de las automatizaciones del CRM.
  • Widget de precios y plugin de WordPress, la especificación OpenAPI 3.1 pública y este portal para desarrolladores.