Portal de Documentação de API's Corporativas
Neste portal você poderá consultar a documentação e status das API's disponíveis para uso corporativo da Embrapa.
A documentação de API é um conjunto de informações detalhadas sobre como interagir com uma API específica. Ela serve como um guia para desenvolvedores, explicando como usar a API, quais recursos estão disponíveis e como interagir com eles.
A documentação está disponível no formato Swagger que oferece detalhe completos das APIs, apresentando a descrição de cada endpoint, métodos disponíveis, tipos de dados esperados e exemplos de uso.
Todas as API's listadas aqui são gerenciadas pelo API Manager corporativo da GTI o Apache APISIX.
Para ter acesso às API"s é necessário fazer uma solicitação ao GTI através dos seguintes passos:
- Realizar a abertura de chamado na Central de TI com a seguinte configuração:
- Tipo de Chamado: Solicitação de Serviço
- Categoria: Sistemas
- Subcategoria: Sistemas Corporativos Embrapa
- Serviço: Conceder/revogar permissão de acesso a sistemas corporativos
- Grupo de operadores: SEDE - 2 - SDSS- APIs e Webservices
- Abrir um chamado para cada sistema/solução (consumidora) identificando as API's e resources que pretendem consumir.
- Os acessos às resources que manipulam dados em sistemas corporativos (PUT, POST e DELETE) estão sujeitos a aprovação pelo gestor da solução. Desta forma é imprescindível que no chamado esteja claro a justificativa de utilização destes recursos.
- No atendimento ao chamado serão criados dois usuários consumer “nome_consumidor_sandbox” e “nome_consumidor_production”. O usuário “nome_consumidor_sandbox” terá acesso somente às API's em desenvolvimento e homologação. As respectivas senhas serão enviadas pelo Google Chat ao solicitante do chamado.
- Chamados e senhas somente serão atendidos/enviados à colaboradores da Embrapa.
- Ao obter acesso às API's o solicitante está automáticamente concordando com os Termos de Uso das API's corporativas.