API Docs

API Docs gerencia as documentações técnicas das suas APIs, que estarão disponíveis em Products.

A documentação é carregada automaticamente no momento da importação da API, mas você também pode adicioná-la manualmente.

Também é possível editar e excluir (quando a documentação tiver sido adicionada manualmente) e visualizar.

Lista de API Docs

A lista de API Docs exibe:

Vendor: indicado pelos ícones (para Sensedia) e (para AWS);
API Name: nome da API, tal como cadastrada na plataforma;
Version: versão da API;
Last revision: última revisão da API;
Availability: informa se a API está disponível para ser exibida no navegador e/ou para ser usada por uma APP;
Actions: a partir desta coluna, você pode editar, deletar e visualizar uma documentação, clicando no ícone respectivo.

screenshot da tela api docs

Os ícones de ação para editar (

) e deletar (

) não estão disponíveis para documentação que foi adicionada automaticamente com a importação da API.

O campo de busca está localizado logo acima da lista de API Docs.

Você pode buscar pela documentação por nome da API e ordenar o resultado por ordem crescente ou decrescente.

Para adicionar uma documentação manualmente, siga os passos abaixo:

Em API Docs, clique no botão + NEW API DOCS.
Na tela seguinte, clique em UPLOAD YOUR FILE, localizado na parte inferior esquerda da tela.
Navegue pelo seu gerenciador de arquivos e selecione o arquivo .yaml ou .json desejado.
Você pode carregar um arquivo por vez.
O arquivo selecionado será exibido na tela. Clique em SAVE para salvar ou REPLACE FILE para escolher outro arquivo.

passos para adicionar nova documentação manualmente

Para verificar se a sua documentação está de acordo com a API importada, siga os passos abaixo:

Em API DOCS, clique no ícone .
A tela seguinte exibirá a última versão do Swagger ou OpenAPI. Caso existam versões anteriores, elas estarão listadas na parte superior da tela. Selecione a versão que deseja visualizar.

Como resultado desses passos, a documentação será carregada e exibida na tela.

Para alterar uma documentação, siga os passos a abaixo:

Em API DOCS, clique em .
Na tela seguinte, clique no botão REPLACE FILE.
Navegue pelo seu gerenciador de arquivos e selecione o arquivo .yaml ou .json desejado.
Você pode carregar um arquivo por vez.
Clique no botão SAVE para salvar ou SAVE AS NEW VERSION para salvar como nova versão.

Thanks for your feedback!

EDIT