Portais API: mudanças entre as edições

De CIGAM WIKI
Linha 19: Linha 19:
</tr>
</tr>
</table>
</table>
 
<br>
<!--
<!--
<table width=550>
<table width=550>
Linha 32: Linha 32:
-->
-->
<!--[[Image: PUT.JPG|center|750px|semmoldura|PUT]]-->
<!--[[Image: PUT.JPG|center|750px|semmoldura|PUT]]-->
<table width=550>
<table width=550>
<tr>
<tr>
<td colspan=2 bgcolor=#7FFFD4>[[File:POST.JPG|125px|alt=POST|title=LOGIN POST|link=LOGIN_POST]] '''/genericos/ge/Padrao/Gravar''' &nbsp;  Realizar filtro</td>
<td colspan=2 bgcolor=#7FFFD4>[[File:POST.JPG|125px|alt=POST|title=LOGIN POST|link=LOGIN_POST]] '''/genericos/ge/Padrao/Gravar''' &nbsp;  Realizar filtro</td>
</tr>
<tr>
<td>&nbsp;</td>
</tr>
<tr>
<td>Parameters</td>
</tr>
<tr>
<td width=30% bgcolor=#ccc>'''Name'''</td>
<td width=70% bgcolor=#ccc>'''Description'''</td>
</tr>
<tr>
<td rowspan=2 valign=top>'''user''' * required
object
''(body)''</td>
<td>Example Value | Model</td>
</tr>
<tr>
<td bgcolor=black><font color=white>{
"Chave": "gecontatosinternos",<br>
"Descricao": "pesquisa_filtrosavancados",<br>
"Identificador": null,<br>
"String_1": "55555"
}</td>
</tr>
<tr>
<td>&nbsp;</td>
</tr>
<tr>
<td>Responses</td>
</tr>
<tr>
<td bgcolor=#ccc>'''Name'''</td>
<td bgcolor=#ccc>'''Description'''</td>
</tr>
<tr>
<td rowspan=2 valign=top>200</td>
<td>Registro gravado<br>Example Value | Model</td>
</tr>
<tr>
<td bgcolor=black><font color=white>{
"success": true,<br>
"hash": "",<br>
"messages": [<br>
"Registro Gravado"<br>
],<br>
"data": {<br>
"Chave": "gecontatosinternos",<br>
"Descricao": "pesquisa_filtrosavancados",<br>
"Identificador": null,<br>
"String_1": "55555"
}</td>
</tr>
<tr>
<td rowspan=2 valign=top>404</td>
<td>File or directory not found.<br>Example Value | Model</td>
</tr>
<tr>
<td bgcolor=black><font color=white>{
message: 404 - File or directory not found.
}</td>
</tr>
</tr>
</table>
</table>

Edição das 20h55min de 31 de março de 2022

Portais > API

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

POST /login   Realizar login


POST /genericos/ge/Padrao/Gravar   Realizar filtro


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.

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:
API_ARC
API_ARC


  • Fazer Login via API


API_LOGIN
API_LOGIN