|
|
| Linha 1: |
Linha 1: |
| === '''Conceito:''' ===
| | 1 Conceito: |
| A palavra
| | 1.1 Interface de programação de aplicação (API) |
| interface é originada do inglês, que significa superfície de contato. Na informatica, o termo é utilizado para referir-se à conexão entre dois ou mais sistemas ou dispositivos.
| | 1.2 Protocolo Simples de Acesso a Objetos (SOAP) |
| | | 1.3 Transferência de Estado Representacional (REST) |
| A interface lógica é uma extensão complementar de interação entre hardwares e sistemas operacionais, que se interagem geralmente por meio da linguagem binária. Para a transmissão de dados são utilizados os endereços da posição de memória, chamadas de portas.
| | 1.4 Exemplos de códigos: |
| | | 1.4.1 -API |
| As portas são utilizadas para armazenar informações e comandos temporariamente até que haja a comunicação entre o sistema e o dispositivo.
| | 1.4.2 -SOAP |
| | | 1.4.3 -REST |
| Exemplo: Funcionamento de uma impressora
| | 1.5 Referências Bibliográfica: |
| | |
| Para que uma impressora possa funcionar é necessário que ela receba um comando, ao clicar em imprimir, as informações do arquivo é enviada para a porta cuja é utilizada pela impressora, que fica armazenada em uma posição da memória, e então a impressora recebe os dados da memoria que são transferidos por um cabo.
| |
| | |
| ==== '''Interface de programação de aplicação (API)''' ====
| |
| | |
| A API é utilizada geralmente em aplicativos e sites, interligando as funções e fazendo a comunicação de vários códigos, fazendo assim a interação com a interface. Ela permite também que um componente de software acesse outro componente através de seu código.
| |
| | |
| Em um sistema operacional também há muitas APIs que dão várias funcionalidades ao programador como de criar arquivos, janelas e manipular blocos de memória. No Windows, ao executar algum programa é feito uma interação entre o software e alguma API presente no Windows como Telephony API, Win16 API e Win32 API.
| |
| | |
| ==== '''Protocolo Simples de Acesso a Objetos (SOAP)''' ====
| |
| O SOAP é um protocolo utilizado para compartilhar informações estruturais de uma interface. Baseia-se basicamente na Linguagem de Marcação Extensível (XML), Chamada de Procedimento Remoto (RPC) e Protocolo de Transferência de Hipertexto (HTTP) normalmente utilizada para construir um serviço Web.
| |
| | |
| Sua estrutura é baseada em XML que consiste na forma de um envelope, que em seu cabeçalho possui opcionalmente o ''Header'' que é utilizado para transmitir informações do aplicativo a serem processadas como caminho da mensagem, e em seguida, obrigatoriamente o elemento ''Body'' que contém informações para o destinatário final da mensagem.
| |
|
| |
| [[Arquivo:SOAP.png]]
| |
| | |
| ==== '''Transferência de Estado Representacional (REST)''' ====
| |
| O REST é uma arquitetura da Web Wide Web (www), que garante a não violação das restrições da Web, e também pode ser utilizado para desenvolver um serviço Web.
| |
| | |
| No inicio o REST era utilizado como princípios de arquitetura, atualmente é utilizado na descrição de qualquer interface que utilize XML ou HTTP, e também para manter a comunicação entre computadores. Para a existência de um REST é necessário ter: Interface uniforme, Stateless, Cacheável, Cliente-Servidor, Sistema em camadas e Código sob demanda.
| |
| | |
| O REST tem uma relação independente entre cliente e servidor.
| |
| | |
| [[Arquivo:Images1.png]]
| |
| | |
| ==== '''Exemplos de códigos:''' ====
| |
| | |
| ===== '''-API''' =====
| |
| Exemplo de código:<syntaxhighlight>
| |
| <?php
| |
| | |
| class Connect{
| |
| | |
| protected $url_acesso = 'http://api.transparencia.org.br/api/v1/';
| |
| protected $app_token = 'YnMjCEoMsbfn';
| |
| | |
| private function sendRequest($getCat){
| |
| | |
| $ch = curl_init($this->url_acesso.$getCat);
| |
| curl_setopt($ch, CURLOPT_HTTPGET, TRUE);
| |
| curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
| |
| | |
| curl_setopt($ch, CURLOPT_HTTPHEADER, array(
| |
| 'App-Token: '.$this->app_token,
| |
| 'Content-Type: application/json',
| |
| 'Accept: application/json'));
| |
| | |
| // Getting results
| |
| | |
| $result = json_decode(curl_exec($ch));
| |
| curl_close($ch);
| |
| return $result;
| |
| }
| |
| | |
| public function getAllCandidates($state,$position=null,$party=null,$name=null){
| |
| | |
| $url = 'candidatos?estado='.$state.'&cargo='.$position;
| |
| if($party != null){
| |
| $url = $url.'&partido='.$party;
| |
| }
| |
| if($name != null){
| |
| $url = $url.'&nome='.$name;
| |
| }
| |
| return $this->sendRequest($url);
| |
| }
| |
| }
| |
| ?>
| |
| </syntaxhighlight>
| |
| | |
| ===== '''-SOAP''' =====
| |
| Envelope SOAP que transporta um objeto com o nome "RevistaNome":<syntaxhighlight>
| |
| <?xml version="1.0"?>
| |
| <soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
| |
| <soap:Header>
| |
| </soap:Header>
| |
| <soap:Body>
| |
| <m:GetRevista xmlns:m="http://www.example.org/revista">
| |
| <m:RevistaNome>Java Magazine</m:ResvistaNome>
| |
| </m:GetRevista>
| |
| </soap:Body>
| |
| </soap:Envelope>
| |
| </syntaxhighlight>
| |
| | |
| ===== '''-REST''' =====
| |
| URLs em REST:<syntaxhighlight>
| |
| /produtos = URL para ações sobre recursos do tipo Produto
| |
| | |
| /produtos/1 = URL para ações sobre um produto específico
| |
| </syntaxhighlight>
| |
| | |
| ==== '''Referências Bibliográfica:''' ====
| |
| http://conceito.de/interface
| |
| | |
| http://www.bpiropo.com.br/Interfac.htm
| |
| | |
| http://www.tecmundo.com.br/programacao/1807-o-que-e-api-.htm
| |
| | |
| http://canaltech.com.br/o-que-e/software/o-que-e-api/
| |
| | |
| http://www.ufpa.br/cdesouza/teaching/labes/apis.pdf
| |
| | |
| https://pt.wikipedia.org/wiki/SOAP
| |
| | |
| https://www.ibm.com/support/knowledgecenter/pt-br/SSKM8N_8.0.0/com.ibm.etools.mft.doc/ac55780_.htm
| |
| | |
| https://pt.wikipedia.org/wiki/REST
| |
| | |
| http://sao-paulo.pm.org/pub/arquitetura-rest-e-o-servico-web-restful-
| |
| | |
| http://www.devmedia.com.br/construindo-uma-api-restful-em-java/29904
| |
| | |
| http://www.devmedia.com.br/web-services-rest-versus-soap/32451
| |
| | |
| http://dev.transparencia.org.br/api-portal/exemplos
| |
1 Conceito:
1.1 Interface de programação de aplicação (API)
1.2 Protocolo Simples de Acesso a Objetos (SOAP)
1.3 Transferência de Estado Representacional (REST)
1.4 Exemplos de códigos:
1.4.1 -API
1.4.2 -SOAP
1.4.3 -REST
1.5 Referências Bibliográfica: