Fipeo para desarrolladores
La API de Fipeo permite a una escuela de idiomas o a una agencia conectar sus propias herramientas con Fipeo: su web, su CRM, su programa de reservas o de contabilidad, Zapier o Make. Es una API REST por HTTPS con JSON, y cada clave solo ve los datos de su organización. Los precios son siempre lo que paga el estudiante: las comisiones y los precios netos nunca salen de Fipeo.
Qué puedes hacer
| Agencias | Escuelas | |
|---|---|---|
| Leer | Las escuelas con las que estás conectado, sus cursos con el precio para el estudiante, presupuestos, reservas y estudiantes | Tu bandeja de reservas |
| Escribir | Añadir estudiantes a tu CRM desde tu web o tu app, con su consentimiento | — |
| Webhooks | Reservas nuevas y cambiadas, presupuestos aceptados, estudiantes nuevos, mensajes nuevos | Reservas nuevas y cambiadas, mensajes nuevos |
| Widget | Los cursos de tus escuelas conectadas con precios en vivo; las solicitudes van a tu CRM | Tus cursos con precios en vivo; las solicitudes van a tu bandeja |
Empieza en 5 minutos
- Crea una clave. Entra en Fipeo y abre Integraciones en el menú (el titular o un administrador de la agencia; en una escuela, su cuenta principal). En Claves de API, ponle un nombre, marca los permisos que necesita y pulsa Crear la clave. Cópiala ahora: empieza por
fpk_y solo se enseña una vez. - Guárdala en secreto. Ponla en una variable de entorno de tu servidor (nunca en una página web, una app ni una URL):
export FIPEO_KEY=fpk_… - Haz tu primera llamada.
/meno necesita ningún permiso y te dice de quién es la clave:
curl https://fipeo.net/api/public/v1/me \
-H "Authorization: Bearer $FIPEO_KEY"{
"organization": { "type": "agency", "id": "a1111111-1111-4111-8111-111111111111" },
"key": { "id": "0f0e0d0c-0b0a-4908-8706-050403020100", "name": "Zapier", "prefix": "fpk_Xy12Ab34", "expires_at": null },
"scopes": ["students:read", "students:write"]
}- Lee o escribe algo. Una agencia con
students:writepuede añadir un estudiante como si hubiera rellenado uno de sus formularios (se crea una oportunidad en el embudo y se avisa a tu equipo):
curl https://fipeo.net/api/public/v1/students \
-H "Authorization: Bearer $FIPEO_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 6f1d0c3e-9b2a-4d5f-8e7c-6b5a49382716" \
-d '{
"first_name": "Lucía",
"last_name": "Pérez",
"email": "[email protected]",
"nationality": "AR",
"consent_text": "I agree that Agencia Sol keeps my details to send me course offers.",
"opportunity_title": "Dublin summer"
}'HTTP/1.1 201 Created
{ "id": "5d1c…", "result": "created", "opportunity_id": "9a7e…" }Con catalog:read, busca los cursos de tus escuelas conectadas con el precio para un estudiante:
curl "https://fipeo.net/api/public/v1/courses?city=Dublin&weeks=4&start=2027-07-05" \
-H "Authorization: Bearer $FIPEO_KEY"- Entérate cuando pase algo con los webhooks, y mira todas las rutas en la referencia de la API.
La especificación OpenAPI
Toda la API está descrita en un fichero OpenAPI 3.1: rutas, parámetros, respuestas, errores, permisos y webhooks. Impórtalo en Postman, Insomnia o Bruno, o genera un cliente con tu generador de OpenAPI favorito. Un test automático comprueba en cada cambio que el fichero coincide con la API real.
Conviene saber
- URL base:
https://fipeo.net/api/public/v1. Solo HTTPS. - Los importes son enteros en céntimos de
currency(100000EUR = 1.000,00 €). Las fechas van comoYYYY-MM-DDy las fechas con hora en ISO 8601 y UTC (2026-11-11T10:00:00Z). Los estados son códigos estables en inglés (accepted,on_request…). - Límites: 120 peticiones por minuto y clave (30 de ellas de escritura). Cada respuesta dice cuántas te quedan (
RateLimit-Remaining,RateLimit-Reset); si te pasas,429conRetry-After. - Las listas van por páginas: sigue
nexthasta que seanull. Repite unPOSTsin miedo con la mismaIdempotency-Key. - Los errores llegan en JSON con un código
errorestable y unmessageen el idioma de tu petición (Accept-Language). - Lo que no es tuyo contesta
404, nunca «prohibido»: Fipeo no revela lo que es de otros. - Dudas: [email protected]. Problemas de seguridad: [email protected] (mira nuestra página de seguridad).
Integraciones
Fipeo ya se conecta con:
- Pagos
- Stripe · PayPal · Klarna
- Exportación contable
- Xero · QuickBooks · Sage 50 · DATEV · Holded · A3
- CRM
- HubSpot
- API y automatización
- REST API · OAuth 2.0 · Webhooks · Zapier · Make
- Tu web
- WordPress · Widget
- Facturación (España)
- Verifactu (AEAT)
- Disponibles bajo petición
- Moodle · Canvas · Google SSO · Microsoft SSO · TYPO3
Algunas aún están en acceso anticipado.
¿Usas una plataforma que no está en la lista?
Cuéntanos cuál y valoraremos integrarla.
Escríbenos a [email protected] con la plataforma y para qué la necesitas.