Portais API: mudanças entre as edições
Sem resumo de edição |
|||
| Linha 6: | Linha 6: | ||
A API CIGAM é utilizada em vários pontos dos portais, para isso é necessário que esteja configurada para que as buscas e movimentações sigam o fluxo correto.</p> | A API CIGAM é utilizada em vários pontos dos portais, para isso é necessário que esteja configurada para que as buscas e movimentações sigam o fluxo correto.</p> | ||
== | == Utilização == | ||
* A API após ser instalada pode ser utilizadas nos portais, para isso é necessário informar a URL da aplicação ou site instalado conforme indicado em [[Portais|Portais]] - API_URL. Quando indicado um site somente para API a URL pode ser utilizada no seguinte formato: http://servidor:porta/API, quando for uma aplicação dentro do site deve ser utilizada assim: http://servidor:porta/API/api<br> | |||
<b>IMPORTANTE</b>: Quando utilizado https com protocolos de segurança é necessário que a API e os portais fiquem dentro do mesmo site para não existir bloqueio devido estarem em portas distintas.<br> | |||
<br> | |||
As APIs utilizam o padrão REST e o formato JSON codificado em UTF-8 para receber e retornar os dados. | |||
O processamento das requisições do tipo GET é feito de modo síncrono. Assim, após a requisição a uma URL os resultados são imediatamente exibidos.<br> | |||
<br> | |||
O processamento das requisições do tipo POST, por sua vez, é feito de modo assíncrono. Para saber o resultado, é necessário acessar a URL que é retornada no cabeçalho Location.<br> | |||
<br> | |||
O resultado contém todas as informações do recurso além dos campos status e response, detalhados na documentação de cada recurso.<br> | |||
<br> | |||
É Recomendado o uso de uma ferramenta do tipo Rest Client para fazer os testes de comunicação com a API, por exemplo a extensão Advanced Rest Client do Chrome. | |||
Edição das 16h58min de 25 de agosto de 2021
API é um conjunto de rotinas e padrões de programação para acesso a um aplicativo de software ou plataforma baseado na Web. A sigla API significa "Interface de Programação de Aplicativos".
A API CIGAM é utilizada em vários pontos dos portais, para isso é necessário que esteja configurada para que as buscas e movimentações sigam o fluxo correto.
Utilização
- A API após ser instalada pode ser utilizadas nos portais, para isso é necessário informar a URL da aplicação ou site instalado conforme indicado em Portais - API_URL. Quando indicado um site somente para API a URL pode ser utilizada no seguinte formato: http://servidor:porta/API, quando for uma aplicação dentro do site deve ser utilizada assim: http://servidor:porta/API/api
IMPORTANTE: Quando utilizado https com protocolos de segurança é necessário que a API e os portais fiquem dentro do mesmo site para não existir bloqueio devido estarem em portas distintas.
As APIs utilizam o padrão REST e o formato JSON codificado em UTF-8 para receber e retornar os dados.
O processamento das requisições do tipo GET é feito de modo síncrono. Assim, após a requisição a uma URL os resultados são imediatamente exibidos.
O processamento das requisições do tipo POST, por sua vez, é feito de modo assíncrono. Para saber o resultado, é necessário acessar a URL que é retornada no cabeçalho Location.
O resultado contém todas as informações do recurso além dos campos status e response, detalhados na documentação de cada recurso.
É Recomendado o uso de uma ferramenta do tipo Rest Client para fazer os testes de comunicação com a API, por exemplo a extensão Advanced Rest Client do Chrome.
