Primeros pasos

Visión general

Filmo expone los registros de una empresa de alquiler, como contactos, artículos, pedidos, facturas y equipo técnico, mediante una API REST y un servidor MCP para asistentes de IA.

Ambos usan la misma clave de API, los mismos scopes y los mismos límites de peticiones. Úsalos para conectar un CRM, enviar a Filmo peticiones de formularios web, replicar el inventario, sincronizar la agenda o dejar que un asistente consulte datos.

  • API REST

    HTTPS y JSON. Cada operación tiene una página, con su scope, sus parámetros y sus respuestas, y el documento OpenAPI completo se puede descargar.

  • Servidor MCP

    Cada operación de la API es también una herramienta para asistentes de IA, con la misma autenticación y los mismos permisos (scopes).

  • Workflows

    Lista los workflows de la cuenta e inicia los que tienen un trigger manual.

  • App SDKPróximamente

    Próximamente: un SDK para crear aplicaciones externas en tu propio entorno con componentes, backend y API de Filmo.

La referencia describe 170 operaciones protegidas por 59 scopes. La API no envía webhooks: para seguir los cambios consultas periódicamente lo que ha cambiado, como Sincronizar datos explains.

  • Un administrador de la cuenta de Filmo crea la clave de API, y la clave actúa como ese administrador. Si no lo eres, el guía rápida indica qué pedir.
  • Filmo debe haber activado la API y MCP para el entorno en el que vive tu cuenta. Es un interruptor del lado de Filmo, no un ajuste que cambie un administrador de la cuenta. La API y MCP están incluidas en cualquier plan de pago y no son un add-on, pero los módulos con add-ons las necesitan: GET /api/v1/account lista los add-ons que tiene hoy la cuenta, y un recurso detrás de un add-on que no figura responde 402 addon_required. Consulta Planes y add-ons.
  • Una prueba gratuita (14 días, sin tarjeta) es una buena forma de probar la API: un administrador puede crear claves y conectar OAuth y MCP, y la prueba desbloquea todos los add-ons. Cuando termina, los endpoints que dependen de un add-on responden 402 y, salvo que la cuenta se haya convertido en una suscripción de pago, sus datos se eliminan unos 30 días después del final. Comprueba trial antes de construir sobre una prueba.
  • Esta documentación es pública. Solo la clave está restringida, y una clave se muestra una vez, cuando se crea.

Los límites de peticiones son los mismos para todos los planes. Para ver qué add-ons tiene tu cuenta, consulta tu suscripción en Filmo (Tu suscripción).

¿Construyes para muchas empresas de alquiler, como proveedor de software? Lee Integraciones con varias cuentas. Los conceptos que toda integración encuentra son cuentas y aislamiento, registros e ids, estados y permisos.

El contrato está versionado. Los cambios dentro de v1 son aditivos; los cambios incompatibles siguen los plazos de aviso de Versionado. Ignora las propiedades y los valores que no conozcas para que los cambios aditivos no rompan tu integración.

Los datos sensibles del negocio, como costes, márgenes y códigos de acceso, no se publican por diseño; consulta Datos excluidos. Si necesitas ayuda, consulta Soporte.

  • Primeros pasos

    Guía rápida

    Crea una clave de API en la sección API y MCP de los ajustes de Filmo y luego llama a GET /api/v1/account. La respuesta te dice la zona horaria, la moneda, los add-ons y los permisos (scopes) con los que construir.

  • Introducción

    Resumen de la API REST

    La API REST v1 de Filmo es una API JSON sobre HTTPS en https://app.filmo.io/api/v1. Te autenticas con una clave de API y todas las respuestas usan el mismo sobre.

  • Introducción

    Servidor MCP

    Conecta un asistente de IA a tu cuenta de Filmo. Puede usar exactamente las herramientas que permita su clave o su conexión.

  • Para saber más

    Capacidades y límites de la v1

    La API cubre la mayor parte del trabajo diario con pedidos, contactos, artículos, facturas y la agenda, y deja una lista corta de cosas a la app. Compruébalo aquí antes de diseñar una integración en torno a una función.

¿Te ha resultado útil esta página?