Componentes do API Connect

Os componentes API Connect oferecem uma experiência de usuário unificada em todo o ciclo de vida da API. As mudanças em um estágio do ciclo de vida da API são refletidas automaticamente nos outros componentes do API Connect

O kit de ferramentas do desenvolvedor

O developer toolkit fornece as ferramentas para modelar, desenvolver e testar APIs. O developer toolkit inclui uma interface da linha de comandos (CLI) e uma interface gráfica com o usuário correspondente, o API Designer.

Os desenvolvedores de API usam as funções de gerenciamento de API no API Designer ou na CLI para criar definições de API de rascunho para APIs REST e SOAP ou para terminais do provedor OAuth que são usados para autenticação OAuth 2.0 . As definições de API podem ser configuradas para incluir a API em um Produto, incluir um fluxo de conjuntos de políticas (para manipular solicitações / respostas), e definir opções de segurança e outras configurações. As APIs podem então ser testadas localmente antes da publicação, para assegurar que sejam definidas e implementadas corretamente.

As APIs de rascunho (em seus Produtos que as contêm) que são criadas usando o API Designerou CLI são publicadas em Catálogos.

O kit de ferramentas do desenvolvedor é instalado localmente, para API off-line e desenvolvimento de aplicativo. Para obter mais informações sobre o kit de ferramentas do desenvolvedor, consulte Desenvolvendo APIs e aplicativos.

API Manager

O API Manager fornece uma interface com o usuário que facilita a promoção e o rastreamento de APIs que são compactadas em Produtos e Planos. Os provedores de API podem mover os Produtos por seu ciclo de vida e gerenciar a disponibilidade e visibilidade de APIs e Planos.

Catálogos e Espaços são criados no API Manager para agir como destinos temporários por meio dos quais APIs, Planos e Produtos são publicados para organizações de consumidores. Os provedores de API podem preparar seus Produtos para Catálogos ou Espaçose, em seguida, publicá-los para tornar as APIs nesses Produtos visíveis em um Portal do Desenvolvedor para descoberta externa

Para controlar o acesso às funções de gerenciamento de API disponíveis, os usuários na organização do provedor podem ser configurados na UI do API Manager com funções e permissões designadas. Os provedores de API também podem usar a UI para gerenciar as organizações de consumidores que se inscrevam para acessar suas APIs e Planos. As comunidades de desenvolvedores também podem ser criadas como uma forma de agrupar um conjunto de organizações de consumidores para as quais um determinado conjunto de produtos e planos pode ser disponibilizado.

A IU do API Manager também inclui funções para gerenciar a segurança do ambiente da API e fornece acesso a informações de analítica sobre métricas de chamada da API dentro de visualizações do painel customizáveis.

Para obter mais informações sobre o API Manager, consulte Gerenciando suas APIs

API Gateways

Os gateways impingem políticas de tempo de execução para proteger e controlar o tráfego da API, fornecer os terminais que expõem as APIs para os aplicativos de chamada e fornecer funções de montagem que permitem que as APIs se integrem a vários terminais Eles também registram e relatam todas as interações da API para o mecanismo de análise do API Connect , para análise e relatório em tempo real e histórico.

tempo de execução

Você pode executar aplicativos e implementações de API em API Connect em um tempo de execução em contêiner.
Tempo de execução em contêineres
Um ambiente de tempo de execução em contêiner fornece um local de implementação leve para APIs e aplicativos. Um contêiner envolve um aplicativo em um sistema de arquivos completo que inclui tudo o que ele precisa para ser executado, como código, tempo de execução, ferramentas do sistema e bibliotecas do sistema. Você pode usar os contêineres Docker Swarm ou Kubernetes para executar suas APIs e aplicativos gerenciados por API Connect.

Portal do Desenvolvedor

O Portal do Desenvolvedor fornece um portal baseado na web de autoatendimento customizável para desenvolvedores de aplicativos explorarem, descobrirem e assinarem APIs.

Quando os provedores de API publicam APIs no API Manager, essas APIs são expostas no Portal do Desenvolvedor para descoberta e uso por desenvolvedores de aplicativos em organizações do consumidor Os desenvolvedores de aplicativos podem acessar a IU do Portal do Desenvolvedor para registrar seus aplicativos, descobrir APIs, usar as APIs necessárias em seus aplicativos (com aprovação de acesso onde necessário) e, subsequentemente, implementar esses aplicativos.

O Portal do Desenvolvedor fornece recursos adicionais, como fóruns, blogues, comentários e avaliações, para socialização e colaboração. Os consumidores de API também podem visualizar informações de analítica sobre as APIs que são usadas por um aplicativo ou usadas em uma organização do consumidor. Para obter mais informações, consulte Portal do Desenvolvedor: Socializar suas APIs.

Análise de dados da API

O API Connect fornece a capacidade de filtrar, classificar e agregar seus dados do evento da API (interface de programação de aplicativos). Esses dados são então apresentados em gráficos, tabelas e mapas correlacionados, para ajudar a gerenciar níveis de serviço, configurar limites de taxa, estabelecer controles, configurar políticas de segurança, gerenciar comunidades e analisar tendências. A análise de dados de API é construída no OpenSearch mecanismo de procura e análise distribuídos em tempo real de software livre. Para obter mais informações, consulte Analytics: entenda seu uso de API.

Tarefas típicas por componente de interface

O API Connect oferece a linha de comandos e interfaces gráficas com o usuário. As organizações do provedor e do consumidor usam interfaces diferentes para concluir tarefas típicas Consulte a tabela a seguir para localizar a interface que corresponde a uma tarefa específica

Tabela 1. API Connect Tarefas por componente de interface
Tipo de organização Componente de Interface. Tarefas
Provedor de API Interface da linha de comandos (CLI) Criar APIs, Planos e Produtos.
UI do API Designer Criar APIs, Planos e Produtos.
UI do API Manager Criar catálogos e espaços; Criar organizações de consumidores
UI do Cloud Manager Criar organizações do provedor
API Consumer (desenvolvedor de aplicativos) Portal do Desenvolvedor Acessar APIs para criar e executar aplicativos; Criar Organizações do Consumidor

Se a integração de autoatendimento for ativada para um Catálogo, uma organização do consumidor será criada automaticamente quando um desenvolvedor de aplicativos se assinar ou for convidado pelo provedor de API para um Portal do Desenvolvedore o desenvolvedor de aplicativos se tornar o proprietário dessa organização do consumidor.