Portais API: mudanças entre as edições
| Linha 21: | Linha 21: | ||
<br> | <br> | ||
<!-- | <!-- | ||
[[File:PUT.JPG|125px|alt=PUT|title=PUT|link=PUT]] | [[File:PUT.JPG|125px|alt=PUT|title=PUT|link=PUT]] | ||
'''/usuarios/{_id}''' Editar usuário | '''/usuarios/{_id}''' Editar usuário | ||
| Linha 36: | Linha 31: | ||
<tr> | <tr> | ||
<td colspan=2 bgcolor=#7FFFD4>[[File:POST.JPG|125px|alt=POST|title=Padrao POST|link=Padrao_POST]] '''/genericos/ge/Padrao/Gravar''' Realizar filtro</td> | <td colspan=2 bgcolor=#7FFFD4>[[File:POST.JPG|125px|alt=POST|title=Padrao POST|link=Padrao_POST]] '''/genericos/ge/Padrao/Gravar''' Realizar filtro</td> | ||
</tr> | |||
</table> | |||
<br> | |||
<table width=550> | |||
<tr> | |||
<td colspan=2 bgcolor=#7FFFD4>[[File:GET.JPG|125px|alt=GET|title=GET|link=GET]] '''/genericos/ge/Padrao/busca''' Pesquisar</td> | |||
</tr> | </tr> | ||
</table> | </table> | ||
Edição das 11h06min de 1 de abril de 2022
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".
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.
APIs CIGAM
 /login Realizar login |
| /genericos/ge/Padrao/Gravar Realizar filtro |
 /genericos/ge/Padrao/busca Pesquisar |
Parametrização
Consulte GE - Como Fazer - Ferramenta de implantação de sites e aplicações web para detalhamento do uso da ferramenta e implantação da aplicação.
Utilização
A API após ser instalada é 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:
- Quando for uma aplicação dentro do site a URL deve ser utilizada assim:
IMPORTANTE: Quando utilizado com protocolos de segurança (https) é necessário que a API e os portais fiquem dentro do mesmo site para não existir bloqueio devido estarem em portas distintas.
É 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.
- Abrir a extensão no crome:
- Fazer Login via API
