Swagger
Em manuais de API, podemos incluir o Swagger para que os usuƔrios possam testar os Endpoints.
Neste artigo
Como funciona
Quando utilizar este componente
Este componente visa realizar a inclusĆ£o do Swagger dentro de pĆ”ginas de documentaĆ§Ć£o de API, desta forma, recomendamos a utilizaĆ§Ć£o em pĆ”ginas onde o usuĆ”rio pode realizar o teste dos Endpoints.
Requisito para instalaĆ§Ć£o
Configurar a inclusĆ£o de conteĆŗdo como Display all included content |
Adicionar os scripts no Help Center |
Pelo menos o idioma portuguĆŖs deve estar ativo no documento de API |
Antes de realizar a instalaĆ§Ć£o, verifique se a API existe na lista abaixo.
Se a API nĆ£o estiver na lista, solicite a um dos Administradores Paulo PaixĆ£o, Catarine Maltauro para adicionar, enviando as seguintes informaƧƵes:
Produto que a API pertence
URL da pĆ”gina no Help Center que o Swagger serĆ” incluĆdo
URL do Swagger disponibilizada pelo desenvolvimento
Produto | PƔgina | URL do Swagger |
---|---|---|
NDD Orbix | api-impressoras | https://developer.nddorbix.com/printer-external-integration-api/index.html |
NDD Orbix | api-estruturacao-organizacional-do-provedor | https://developer.nddorbix.com/core-external-integration-api/index.html |
NDD Orbix | api-de-produtos | https://developer.nddorbix.com/stock-external-integration-api/index.html |
NDD Move | apis-de-integracao-nddmove | |
NDD Averba | manual-nddaverba-apis-de-integracao |
InstalaĆ§Ć£o
ApĆ³s atender ao requisito, basta realizar a inclusĆ£o da pĆ”gina component-swagger Ć s pĆ”ginas que deseja que o Componente fique disponĆvel:
Encontrou algum problema? Procure os administradores Catarine Maltauro da Silva ou Paulo Henrique PaixĆ£o para ajustes.