Esta página se aplica à Apigee e à Apigee híbrida.
Confira a documentação da
Apigee Edge.
A publicação é o processo de disponibilização das APIs para os desenvolvedores de apps para consumo.
Vídeo: apresenta a introdução de alto nível da publicação da API.
A publicação de APIs envolve as seguintes tarefas, descritas neste tópico:
- Criar os produtos de API que agrupam suas APIs.
- Registrar desenvolvedores de apps.
- Registrar apps de desenvolvedores.
- Fornecer documentação e suporte da comunidade para suas APIs.
Tarefa 1: crie um produto de API
A primeira tarefa na publicação é criar um produto de API. Um produto de API é um conjunto de recursos de API que é oferecido como um pacote para desenvolvedores de apps para consumo. Crie produtos de API usando a API ou a IU da Apigee. Consulte O que é um produto de API? para saber mais sobre os produtos de API.
Nesta figura, a API consiste em dois produtos, cada um contendo três recursos de API.
Como provedor de APIs, você é responsável por criar as APIs e os produtos de API para lidar com controle de acesso, restrições de uso e quaisquer outros requisitos comerciais. Por exemplo, é possível:
- Lançar um produto de API gratuito que permita acesso somente leitura aos recursos da API.
- Lançar um segundo produto de API por um preço baixo que permite acesso de leitura/gravação aos mesmos recursos da API que a versão gratuita, mas com um limite de acesso baixo, como 1.000 solicitações por dia.
- Lançar um terceiro produto de API por um preço mais alto que permite acesso de leitura/gravação ao mesmo recurso da API, mas com um limite de acesso alto.
É importante lembrar que a Apigee oferece a flexibilidade de criar produtos de API que correspondam aos requisitos de negócios das suas APIs.
Para mais informações sobre como criar produtos de API, consulte Como gerenciar produtos de API.
Tarefa 2: registrar um desenvolvedor de apps
Um desenvolvedor cria os aplicativos que consomem suas APIs. Um desenvolvedor de apps é registrado na Apigee antes de registrar o app. Ao registrar o app, ele recebe uma chave de API que dará ao app acesso à API.
Com o processo de registro de aplicativos, você controla quem tem acesso às suas APIs. A qualquer momento, é possível excluir um desenvolvedor de apps, que invalida todas as chaves de API associadas a ele, negando esse acesso às APIs.
Como provedor de APIs, você decide como registrar desenvolvedores. Por exemplo, use um processo de registro manual que exige que um possível desenvolvedor entre em contato com sua organização para se registrar. O desenvolvedor em potencial precisa fornecer todas as informações necessárias, como endereço de e-mail, nome e sobrenome. Se você aprovar a solicitação do desenvolvedor, será possível usar a IU da Apigee para registrá-lo manualmente. Consulte Como registrar desenvolvedores de apps para mais informações.
Tarefa 3: registrar um app de desenvolvedor
Antes de acessar as APIs, o app precisa estar registrado. No entanto, apenas um desenvolvedor registrado pode registrar um app.
No momento do registro do app, o desenvolvedor seleciona um ou mais produtos de API. Por exemplo, publique vários produtos de API correspondentes a diferentes tipos de serviços e planos de preços. O desenvolvedor do app pode escolher na lista de produtos de API disponíveis.
Em resposta a um registro de app na Apigee, a Apigee atribui uma chave de API exclusiva a ele. O app precisa transmitir essa chave de API como parte de cada solicitação para um recurso de API. A chave é autenticada e, se válida, a solicitação será concedida. A qualquer momento, você, como provedor de serviços, consegue revogar a chave para que o aplicativo não acesse suas APIs.
Como provedor de API, você decide como registrar apps. É possível:
- Use um processo manual que exige que um desenvolvedor entre em contato com sua organização para registrar o app. Em resposta, você precisa enviar ao desenvolvedor a chave de API, possivelmente por e-mail.
- Use a API da Apigee para integrar a funcionalidade de registro de apps e a entrega de chaves ao seu site.
- Para uma conta paga da Apigee, use o portal de serviços para desenvolvedores da Apigee, que tem suporte integrado para registro de apps e entrega de chaves de API.
Para mais informações, consulte Como registrar apps e gerenciar chaves de API.
Tarefa 4: documentar suas APIs
Uma consideração importante para publicar produtos de API é fornecer documentação e um mecanismo de feedback do desenvolvedor. Os portais do desenvolvedor com recursos de publicação social estão sendo usados cada vez mais para se comunicar com a comunidade de desenvolvimento. Isso inclui a comunicação de conteúdo estático, como documentação e Termos de Uso da API, além de conteúdo dinâmico gerado pela comunidade, como blogs e fóruns, além de recursos de suporte ao cliente.
É possível criar seu próprio site para implantar a documentação ou, se você tiver uma conta da Apigee paga, é possível usar o portal de serviços para desenvolvedores da Apigee. O portal tem suporte integrado para documentação, blogs, fóruns e outros tipos de conteúdo necessários para apoiar sua comunidade de desenvolvedores.
O SmartDocs permite documentar suas APIs no portal dos Serviços do desenvolvedor de um modo que torna a documentação da API totalmente interativa. A documentação interativa com o SmartDocs permite que os usuários do portal possam:
- Ler sobre a API
- Enviar uma solicitação em tempo real à API
- Visualizar uma resposta em tempo real retornada da API
Para mais informações, consulte as seguintes seções:
- Portal integrado: como publicar suas APIs
- Drupal 10: documente suas APIs