API

Esta pesquisa deve fornecer um conteúdo atualizado sobre o tema acima. Não esqueça de incluir as  
referëncias (fontes) no último item, reforçando que não deve ser um Copy/Paste e sim uma síntese 
das pesquisas que fizer.

Conceito

Antes de tudo, deve-se ter em mente que uma interface lógica é uma "interface" que permite que haja uma comunicação entre dois sistemas. Uma API é um recurso de um sistema que permite que esse se comunique com outro sistema. É possível citar vários exemplos de api's, visto que atualmente a grande maioria dos sistemas "conversam" com outros sistemas. Por exemplo, quando um aplicativo permite que o usuário se autentique nele através do facebook, isso ocorre graças à uma api que permite que o aplicativo solicite as informações necessárias para o sistema do facebook e o facebook as envia, possibilitando o usuário autenticar-se no sistema sem necessariamente se cadastrar nele em si. Outro bom exemplo é quando o usuário está em um site de turismo ou em alguma outra aplicação que disponibiliza mapas. Esses mapas, quase sempre, são fornecidos pelo Google Maps, através de um api entre os sistemas.

Concluindo, API's são padrões feitos pelos programadores dos respectivos softwares para que outros softwares possam utilizar alguns serviços, sem precisar implantar tal funcionalidade no próprio software. É como se um software pedisse uma aplicação "emprestada" para outro software.

Protocolos

Protocolo é uma convenção que possibilita e governa a comunicação entre dois sistemas. Ele pode ser implementado por hardware, software ou pelos dois.

Alguns Exemplos de protocolos são TCP/IP, DHCP, TCP, entre outros. Porém, o protocolo mais importante quando se fala em API web é o protocolo HTTP(Hypertext Transfer Protocol), pois esse é o fator mais importante para a comunicação de dados na World Wide Web(WWW).

Vantagens

As API's levam vantagem quando comparadas a outros tipos de comunicação. Por exemplo, quando comparada à web services, pode-se até mesmo considerar que todo web service é uma api, porém não é toda api que é um web service. Primeiro pois web services servem apenas para comunicação web, enquanto os api's podem ser utilizados para comunicação local e até mesmo apenas dentro de um sistema operacional. E também as web services usam apenas 3 meios de comunicação: SOAP, REST e XML-RPC, enquanto as api's podem utilizar qualquer meio.

Exemplos de código

Modelo de código para logar no app com o facebook(em PHP):

<?php session_start(); if($_SERVER['REQUEST_METHOD'] == 'GET' && isset($_GET['code'])){

 // Informe o seu App ID abaixo
 $appId = '29048572934875';

 // Digite o App Secret do seu aplicativo abaixo:
 $appSecret = '123456789';

 // Url informada no campo "Site URL"
 $redirectUri = urlencode('http://fb.matheusafonso.com/');

 // Obtém o código da query string
 $code = $_GET['code'];

 // Monta a url para obter o token de acesso e assim obter os dados do usuário
 $token_url = "https://graph.facebook.com/oauth/access_token?"
 . "client_id=" . $appId . "&redirect_uri=" . $redirectUri
 . "&client_secret=" . $appSecret . "&code=" . $code;

 //pega os dados
 $response = @file_get_contents($token_url);
 if($response){
   $params = null;
   parse_str($response, $params);
   if(isset($params['access_token']) && $params['access_token']){
     $graph_url = "https://graph.facebook.com/me?access_token="
     . $params['access_token'];
     $user = json_decode(file_get_contents($graph_url));

   // nesse IF verificamos se veio os dados corretamente
     if(isset($user->email) && $user->email){

   /*
   *Apartir daqui, você já tem acesso aos dados usuario, podendo armazená-los
   *em sessão, cookie ou já pode inserir em seu banco de dados para efetuar
   *autenticação.
   *No meu caso, solicitei todos os dados abaixo e guardei em sessões.
   */

       $_SESSION['email'] = $user->email;
       $_SESSION['nome'] = $user->name;
       $_SESSION['localizacao'] = $user->location->name;
       $_SESSION['uid_facebook'] = $user->id;
       $_SESSION['user_facebook'] = $user->username;
       $_SESSION['link_facebook'] = $user->link;
     }
   }else{
     echo "Erro de conexão com Facebook";
     exit(0);
   }

 }else{
   echo "Erro de conexão com Facebook";
   exit(0);
 }

}else if($_SERVER['REQUEST_METHOD'] == 'GET' && isset($_GET['error'])){

 echo 'Permissão não concedida';

} ?>

Referências bibliográficas

http://canaltech.com.br/o-que-e/software/o-que-e-api/

http://www.tecmundo.com.br/programacao/1807-o-que-e-api-.htm

https://pt.wikipedia.org/wiki/Interface_de_programa%C3%A7%C3%A3o_de_aplica%C3%A7%C3%B5es

http://www.devmedia.com.br/application-programming-interface-desenvolvendo-apis-de-software/30548

https://en.wikipedia.org/wiki/Application_programming_interface

https://pt.wikipedia.org/wiki/Protocolo_(ci%C3%AAncia_da_computa%C3%A7%C3%A3o)

https://pt.wikipedia.org/wiki/World_Wide_Web

https://pt.wikipedia.org/wiki/Hypertext_Transfer_Protocol

http://sensedia.com/blog/apis/o-que-sao-apis-parte-2-como-uma-api-funciona/

https://fxcosta.wordpress.com/2015/05/31/diferenca-entre-api-e-web-service-de-maneira-simples/