fusio

Acerca de

Fusio es una plataforma de gestión de API de código abierto que ayuda a crear soluciones API innovadoras.

Casos de uso

• Producto API
  Fusio le ayuda a crear un excelente producto API; además de crear una API, proporciona un portal para desarrolladores donde los desarrolladores pueden registrarse y una forma de monetizar su API.
• Puerta de enlace API
  Fusio se puede utilizar como puerta de entrada a su API y microservicios internos. Maneja todas las funciones comunes como autorización, limitación de velocidad y validación de esquemas.
• SPA-Backend
  Fusio se puede utilizar como backend para crear SPA utilizando marcos de Javascript populares como Angular, React o Vue. Proporciona un potente generador de código que puede generar automáticamente un SDK para su API.
• Plataforma de código bajo
  Fusio le permite crear puntos finales API sin conocimientos de codificación. Es decir, proporciona un generador de entidades que puede utilizar para crear fácilmente API CRUD completas.
• Marco API
  Para casos de uso más complejos, puede utilizar Fusio también como marco para crear API completas desde cero. Esto significa que puede crear acciones personalizadas en las que puede utilizar el amplio ecosistema PHP para resolver su tarea.

Características

Fusio le ayuda a crear API que proporcionan funciones empresariales listas para usar para que pueda concentrarse en su caso de negocio. Eche un vistazo a nuestro sitio web de documentación para obtener más información. La siguiente lista de funciones le ofrece una primera descripción general:

• Generación de API abierta
  Fusio genera automáticamente una especificación OpenAPI para las rutas definidas
• Generación de SDK
  Fusio puede generar automáticamente un SDK de cliente para su API según el esquema definido
• Soporte de webhook
  Fusio contiene un sistema de webhook que ayuda a crear publicación/suscripción para su API.
• Limitación de velocidad
  Fusio proporciona una forma de calificar las solicitudes de límite según el usuario o la aplicación
• Autorización
  Fusio usa OAuth2 para la autorización de API
• Monetización
  Fusio proporciona un sistema de pago sencillo para cobrar por rutas específicas
• Validación
  Fusio utiliza TypeSchema para validar automáticamente los datos de la solicitud entrante
• Analítica
  Fusio monitorea todas las actividades de la API y las muestra en un panel
• Gestión de usuarios
  Fusio proporciona una aplicación para desarrolladores donde los nuevos usuarios pueden iniciar sesión o registrar una nueva cuenta a través de GitHub, Google, Facebook o mediante el registro normal por correo electrónico.

Aplicaciones

Fusio proporciona muchas aplicaciones que ayudan a trabajar con la API. La mayoría de las aplicaciones son aplicaciones JS simples, que funcionan con la API interna de Fusio. Puede ver una lista de todas las aplicaciones disponibles en nuestro mercado. Puede instalar dicha aplicación mediante un comando CLI, es decir, php bin/fusio marketplace:install fusio o mediante la aplicación backend.

Todas las aplicaciones se instalan en la carpeta apps/ . Debe indicarle a Fusio la URL pública de la carpeta de aplicaciones en el archivo .env definiendo la variable APP_APPS_URL . Dependiendo de su configuración, puede ser un subdominio personalizado como https://apps.acme.com o simplemente la subcarpeta https://acme.com/apps .

backend

La aplicación backend es la aplicación principal para configurar y administrar su API. El instalador instala automáticamente esta aplicación. La aplicación se encuentra en /apps/fusio/ .

Código VS

Fusio proporciona una extensión VSCode que se puede utilizar para simplificar el desarrollo de acciones. Esto significa que puedes desarrollar cada acción directamente dentro del editor VSCode.

SDK

Para crear e integrar aplicaciones con Fusio, proporcionamos varios SDK que puede usar para trabajar con una instancia de Fusio o también puede simplemente hablar manualmente con la API REST.

Idioma	GitHub	Paquete	Ejemplo
DO#	GitHub	NuGet	Ejemplo
Ir	GitHub		Ejemplo
Java	GitHub	experto	Ejemplo
JavaScript	GitHub	MNP
PHP	GitHub	empaquetador	Ejemplo
Pitón	GitHub	PyPI	Ejemplo

Marcos

Estructura	GitHub	Paquete	Ejemplo
Angular	GitHub	MNP	Ejemplo

API DESCANSO

Dominio	Documentación	Especificación
backend	Redoc	API abierta
Consumidor	Redoc	API abierta
Sistema	Redoc	API abierta

Ecosistema

Fusio es un proyecto de código abierto que puedes utilizar libremente para proyectos privados y comerciales bajo los términos de la licencia Apache 2.0. Además de nuestro producto principal, ofrecemos servicios adicionales para aumentar la funcionalidad de Fusio.

• SDKgen
  SDKgen es un potente generador de código para crear automáticamente SDK de cliente para su API REST.
• APIgen
  Genere API completamente funcionales y personalizables basadas en su modelo de datos.
• APImon
  APImon proporciona un servicio intuitivo para monitorear y analizar puntos finales API.
• TipoEsquema
  Un formato JSON para describir modelos de datos en un formato de lenguaje neutro.
• Tipo API
  Una alternativa de OpenAPI para describir las API REST para la generación de código con seguridad de tipos.
• TipoHub
  Una plataforma colaborativa para diseñar y construir modelos API y SDK de clientes.
• PSX
  Un marco PHP innovador dedicado a crear API REST completamente tipificadas.

Instalación

Es posible instalar Fusio mediante Composer o descargando archivos manualmente.

Compositor

 composer create-project fusio/fusio

Descargar

https://github.com/apioo/fusio/releases

Configuración

Puede instalar Fusio manualmente siguiendo los pasos a continuación o también puede usar el instalador basado en navegador en public/install.php . Tenga en cuenta que, por motivos de seguridad, se recomienda encarecidamente eliminar el script del instalador después de la instalación.

• Ajustar el archivo de configuración
  Abra el archivo .env en el directorio de Fusio y cambie APP_URL al dominio que apunta a la carpeta pública. Inserte también las credenciales de la base de datos en las claves APP_CONNECTION . Opcionalmente ajuste APP_APPS_URL a la URL pública de la carpeta de aplicaciones (en caso de que desee utilizar aplicaciones).
• Ejecute el comando de instalación.
  El script de instalación inserta el esquema de la base de datos Fusio en la base de datos proporcionada. Se puede ejecutar con el siguiente comando php bin/fusio migrate .
• Crear usuario administrador
  Una vez completada la instalación, debe crear una nueva cuenta de administrador. Para ello puede utilizar el siguiente comando php bin/fusio adduser . Elija como tipo de cuenta "Administrador".
• Instalar la aplicación de fondo
  Para administrar su API a través de un panel de administración, necesita instalar la aplicación backend. La aplicación se puede instalar con el siguiente comando php bin/fusio marketplace:install fusio

Puede verificar la instalación visitando APP_URL con un navegador. Debería ver una respuesta de API indicando que la instalación se realizó correctamente.

En caso de que desee instalar Fusio en una base de datos específica, debe ajustar el parámetro APP_CONNECTION . Puede utilizar las siguientes cadenas de conexión:

• MySQL: pdo-mysql://root:test1234@localhost/fusio
• PostgreSQL: pdo-pgsql://postgres:postgres@localhost/fusio
• SQLite: pdo-sqlite:///fusio.sqlite

En general, es posible instalar Fusio en todas las bases de datos compatibles con nuestra capa de abstracción de bases de datos, pero nuestros casos de prueba internos solo cubren MySQL, PostgreSQL y SQLite, por lo que no hay garantía de que todo funcione.

Estibador

Es posible configurar Fusio a través de la ventana acoplable. Esto tiene la ventaja de que automáticamente obtiene un sistema Fusio en ejecución completo sin configuración. Esto es especialmente bueno para pruebas y evaluaciones. Para configurar el contenedor, debe verificar el repositorio y ejecutar el siguiente comando:

 docker-compose up -d

Esto construye el sistema Fusio con una cuenta de backend predefinida. Las credenciales se toman de las variables de entorno FUSIO_BACKEND_USER , FUSIO_BACKEND_EMAIL y FUSIO_BACKEND_PW en docker-compose.yml . Si planea ejecutar el contenedor en Internet, debe cambiar estas credenciales.

Dominios

De forma predeterminada, el proyecto Fusio completo se puede alojar en un único dominio. En esta configuración, su API se sirve en el directorio raíz y el portal de desarrollador y las aplicaciones de backend se sirven directamente desde la carpeta /apps. Esta configuración es fácil de usar ya que no requiere configuración. Si desea ejecutar Fusio en un entorno de producción, le recomendamos crear la siguiente estructura de subdominio:

• api.acme.com
  Contiene solo Fusio donde se sirve su API, en este caso puede eliminar la carpeta apps/ de la carpeta public/
• desarrollador.acme.com
  Contiene la aplicación del portal para desarrolladores donde los desarrolladores externos pueden registrarse.
• fusio.acme.com
  Opcional, la aplicación backend donde puedes administrar tu instancia de Fusio. También puede alojar esto en un dominio interno completamente separado; la aplicación backend solo necesita acceso a la API de Fusio.

Por supuesto, esto es sólo una sugerencia y usted es libre de elegir los nombres de dominio que desee.

Documentación

Consulte nuestro sitio web de documentación oficial donde agrupamos todos los recursos de documentación: https://docs.fusio-project.org/

Apoyo

Promoción

Si eres un blogger o una revista, estaremos encantados de que quieras cubrir Fusio. Eche un vistazo a la sección Medios de nuestra página Acerca de para descargar el conjunto de iconos oficiales. En caso de que tenga alguna pregunta, escríbanos un mensaje directamente para que podamos ayudarlo a crear contenido excelente.

Consultante

Si eres una empresa o un autónomo y quieres obtener información detallada sobre cómo puedes utilizar Fusio, puedes contactarnos para asesorarte. En el taller tratamos de encontrar la mejor manera de utilizar/integrar Fusio. También intentamos explicar la funcionalidad y responder a sus preguntas.

Donaciones

Si este proyecto le ayuda a generar ingresos o, en general, si desea apoyar el proyecto, consulte las opciones de donación en nuestro repositorio.

Pareja

La siguiente lista muestra todos los socios del proyecto Fusio. Nos gustaría agradecer a todos los socios que nos apoyan en nuestra visión de llevar el desarrollo de API al siguiente nivel. Si está interesado en figurar aquí, no dude en patrocinar nuestro proyecto.