Webservices Base de conhecimento

Efetuar login pelo método POST
https://www.wportal.pt/api/getlogin/json

Parâmetros a enviar (Array)
Parâmetro Tipo Defeito Descrição
privatekey CHAVE_PRIVADA_DA_EMPRESA Chave de identificação privada da empresa fornecida pela Wincode. Esta chave é confidencial.
username varchar(20) obrigatório Número de contribuinte do utilizador
password md5() obrigatório Password encriptada md5()
Variáveis de Retorno
Nome Tipo (Valores) Descrição
status boolean (true,false) Resultado da operação
message["id"] int (0,1,2) Identificação da mensagem
  • 0 Sem erros
  • 1 Dados de login errados
  • 2 Utilizador inexistente
message["text"] string Mensagem de retorno do webservice
url string Url para redirecionamento ao portal
utilizador string (c,f) Identificação do utilizador
  • c Cliente
  • f Funcionário
Exemplo pelo método JSON
$data = array(
     'privatekey' => "CHAVE_PRIVADA_DA_EMPRESA",
     'username'   => "999999999",
     'password'   => md5("123456")
);

//transformar data do $_POST para JSON
$content = json_encode($data);

//submeter o webservice por CURL
$curl = curl_init("https://www.wportal.pt/api/getlogin/json");
curl_setopt($curl, CURLOPT_HEADER, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, $content);

$json_response = curl_exec($curl);

$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);

curl_close($curl);

//resposta do webservice
$response = json_decode($json_response, true);

echo $response["message"]["text"];