fusio

Sobre

Fusio é uma plataforma de gerenciamento de API de código aberto que ajuda a criar soluções API inovadoras.

Casos de uso

• Produto API
  Fusio ajuda você a criar um ótimo produto de API, além de construir uma API fornece um portal de desenvolvedores onde os desenvolvedores podem se registrar e uma forma de monetizar sua API
• Gateway de API
  O Fusio pode ser usado como porta de entrada para sua API interna e microsserviços. Ele lida com todos os recursos comuns, como autorização, limitação de taxa e validação de esquema
• Back-end do SPA
  O Fusio pode ser usado como back-end para construir SPAs usando Javascript-Frameworks populares, como Angular, React ou Vue. Ele fornece um poderoso gerador de código que pode gerar automaticamente um SDK para sua API
• Plataforma de baixo código
  O Fusio permite que você crie endpoints de API sem conhecimento de codificação. Ou seja, ele fornece um gerador de entidades que você pode usar para criar facilmente APIs CRUD completas.
• Estrutura API
  Para casos de uso mais complexos, você também pode usar o Fusio como estrutura para construir APIs completas do zero. Isso significa que você cria ações personalizadas onde pode usar o amplo ecossistema PHP para resolver sua tarefa.

Características

O Fusio ajuda você a criar APIs, fornecendo recursos empresariais prontos para uso, para que você possa se concentrar em seu caso de negócios. Por favor, dê uma olhada em nosso site de documentação para obter mais informações. A lista de recursos a seguir oferece uma primeira visão geral:

• Geração OpenAPI
  Fusio gera automaticamente uma especificação OpenAPI para as rotas definidas
• Geração de SDK
  O Fusio pode gerar automaticamente um SDK cliente para sua API com base no esquema definido
• Suporte para webhook
  Fusio contém um sistema de webhook que ajuda a construir publicação/assinatura para sua API
• Limitação de taxa
  Fusio fornece uma maneira de avaliar solicitações de limite com base no usuário ou aplicativo
• Autorização
  Fusio usa OAuth2 para autorização de API
• Monetização
  Fusio oferece um sistema de pagamento simples para cobrar rotas específicas
• Validação
  Fusio usa o TypeSchema para validar automaticamente os dados de solicitação recebidos
• Análise
  Fusio monitora todas as atividades da API e as mostra em um painel
• Gerenciamento de usuários
  Fusio fornece um aplicativo para desenvolvedores onde novos usuários podem fazer login ou registrar uma nova conta através do GitHub, Google, Facebook ou através do registro normal de e-mail

Aplicativos

A Fusio oferece muitos aplicativos que ajudam a trabalhar com a API. A maioria dos aplicativos são aplicativos JS simples, que funcionam com a API interna do Fusio. Você pode ver uma lista de todos os aplicativos disponíveis em nosso mercado. Você pode instalar esse aplicativo por meio de um comando CLI, ou seja, php bin/fusio marketplace:install fusio ou por meio do aplicativo back-end.

Todos os aplicativos são instalados na pasta apps/ . Você precisa informar ao Fusio o URL público para a pasta de aplicativos no arquivo .env definindo a variável APP_APPS_URL . Dependendo da sua configuração, pode ser um subdomínio personalizado como https://apps.acme.com ou simplesmente a subpasta https://acme.com/apps .

Back-end

O aplicativo backend é o aplicativo principal para configurar e gerenciar sua API. O instalador instala este aplicativo automaticamente. O aplicativo está localizado em /apps/fusio/ .

Código VSC

Fusio fornece uma extensão VSCode que pode ser usada para simplificar o desenvolvimento de ações. Isso significa que você pode desenvolver cada ação diretamente dentro do editor VSCode.

SDK

Para construir e integrar aplicativos com o Fusio, fornecemos vários SDKs que você pode usar para trabalhar com uma instância do Fusio ou também pode simplesmente conversar manualmente com a API REST.

Linguagem	GitHub	Pacote	Exemplo
C#	GitHub	NuGet	Exemplo
Ir	GitHub		Exemplo
Java	GitHub	Maven	Exemplo
JavaScript	GitHub	NPM
PHP	GitHub	Empacotador	Exemplo
Pitão	GitHub	PyPI	Exemplo

Estruturas

Estrutura	GitHub	Pacote	Exemplo
Angular	GitHub	NPM	Exemplo

API REST

Domínio	Documentação	Especificação
Back-end	ReDoc	API aberta
Consumidor	ReDoc	API aberta
Sistema	ReDoc	API aberta

Ecossistema

Fusio é um projeto de código aberto que você pode usar livremente para projetos privados e comerciais sob os termos da licença Apache 2.0. Além do nosso produto principal, oferecemos serviços adicionais para aumentar a funcionalidade do Fusio.

• SDKgen
  SDKgen é um poderoso gerador de código para construir automaticamente SDKs de cliente para sua API REST.
• APIgen
  Gere APIs totalmente funcionais e personalizáveis ​​com base no seu modelo de dados.
• APImon
  APImon fornece um serviço intuitivo para monitorar e analisar endpoints de API.
• Esquema de tipo
  Um formato JSON para descrever modelos de dados em um formato de linguagem neutra.
• Tipo API
  Uma alternativa OpenAPI para descrever APIs REST para geração de código com segurança de tipo.
• TipoHub
  Uma plataforma colaborativa para projetar e construir modelos de API e SDKs de clientes.
• PSX
  Uma estrutura PHP inovadora dedicada à construção de APIs REST totalmente digitadas.

Instalação

É possível instalar o Fusio através do compositor ou download manual do arquivo.

Compositor

 composer create-project fusio/fusio

Download

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

Configuração

Você pode instalar manualmente o Fusio seguindo as etapas abaixo ou também pode usar o instalador baseado em navegador em public/install.php . Observe que, por motivos de segurança, é altamente recomendável remover o script do instalador após a instalação.

• Ajuste o arquivo de configuração
  Abra o arquivo .env no diretório Fusio e altere APP_URL para o domínio apontando para a pasta pública. Insira também as credenciais do banco de dados nas chaves APP_CONNECTION . Opcionalmente, ajuste APP_APPS_URL para a url pública da pasta de aplicativos (caso você queira usar aplicativos).
• Execute o comando de instalação
  O script de instalação insere o esquema do banco de dados Fusio no banco de dados fornecido. Pode ser executado com o seguinte comando php bin/fusio migrate .
• Criar usuário administrador
  Após a conclusão da instalação, você deverá criar uma nova conta de administrador. Para isso você pode usar o seguinte comando php bin/fusio adduser . Escolha como tipo de conta "Administrador".
• Instale o aplicativo de back-end
  Para gerenciar sua API por meio de um painel de administração, você precisa instalar o aplicativo backend. O aplicativo pode ser instalado com o seguinte comando php bin/fusio marketplace:install fusio

Você pode verificar a instalação visitando APP_URL com um navegador. Você deverá ver uma resposta da API informando que a instalação foi bem-sucedida.

Caso queira instalar o Fusio em um banco de dados específico é necessário ajustar o parâmetro APP_CONNECTION . Você pode usar as seguintes cadeias de conexão:

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

Em geral, é possível instalar o Fusio em todos os bancos de dados suportados pela nossa camada de abstração de banco de dados, mas nossos casos de teste internos cobrem apenas MySQL, PostgreSQL e SQLite, portanto não há garantia de que tudo funcione.

Docker

É possível configurar o Fusio através do docker. Isso tem a vantagem de obter automaticamente um sistema Fusio completo em execução, sem configuração. Isso é especialmente ótimo para testes e avaliações. Para configurar o contêiner você deve fazer checkout do repositório e executar o seguinte comando:

 docker-compose up -d

Isso cria o sistema Fusio com uma conta de back-end predefinida. As credenciais são obtidas das variáveis ​​de ambiente FUSIO_BACKEND_USER , FUSIO_BACKEND_EMAIL e FUSIO_BACKEND_PW no docker-compose.yml . Se você planeja executar o contêiner na Internet, deverá alterar essas credenciais.

Domínios

Por padrão, o projeto Fusio completo pode ser hospedado em um único domínio. Nesta configuração, sua API é veiculada no diretório raiz e o portal do desenvolvedor e os aplicativos de back-end são veiculados diretamente na pasta /apps. Esta configuração é fácil de usar, pois não requer configuração. Se você deseja executar o Fusio em um ambiente de produção, recomendamos criar a seguinte estrutura de subdomínio:

• api.acme.com
  Contém apenas o Fusio onde sua API é atendida, neste caso você pode deletar a pasta apps/ da pasta public/
• desenvolvedor.acme.com
  Contém o aplicativo do portal do desenvolvedor onde desenvolvedores externos podem se registrar
• fusio.acme.com
  Opcional, o aplicativo backend onde você pode gerenciar sua instância Fusio. Você também pode hospedar isso em um domínio interno totalmente separado, o aplicativo de back-end só precisa de acesso à API Fusio.

É claro que esta é apenas uma sugestão e você é livre para escolher os nomes de domínio que desejar.

Documentação

Confira nosso site oficial de documentação, onde agrupamos todos os recursos de documentação: https://docs.fusio-project.org/

Apoiar

Promoção

Se você é um blogueiro ou revista, ficaríamos felizes se você gostasse de cobrir o Fusio. Por favor, dê uma olhada na seção Mídia de nossa página Sobre para baixar o conjunto oficial de ícones. Caso você tenha alguma dúvida, escreva-nos uma mensagem diretamente para que possamos ajudá-lo a criar um ótimo conteúdo.

Consultoria

Se você é uma empresa ou freelancer e deseja obter informações detalhadas sobre como usar o Fusio, entre em contato conosco para consultoria. No workshop tentamos encontrar a melhor forma de utilizar/integrar o Fusio, também tentamos explicar a funcionalidade e responder às suas questões.

Doações

Se este projeto ajuda você a gerar receita ou em geral se você gosta de apoiar o projeto confira as opções de doação em nosso repositório.

Parceiro

A lista a seguir mostra todos os parceiros do projeto Fusio. Gostaríamos de agradecer a todos os parceiros que nos apoiam em nossa visão de levar o desenvolvimento de APIs para o próximo nível. Se você estiver interessado em ser listado aqui, sinta-se à vontade para patrocinar nosso projeto.