Webservices Base de conhecimento

Lista de candidaturas por oferta de emprego pelo método GET
https://www.wportal.pt/api/candidaturas/json/?key=CHAVE_DA_EMPRESA
https://www.wportal.pt/api/candidaturas/json/?key=CHAVE_DA_EMPRESA&id=[id_emp]
https://www.wportal.pt/api/candidaturas/json/?key=CHAVE_DA_EMPRESA&cand=[num_cand]
https://www.wportal.pt/api/candidaturas/json/?key=CHAVE_DA_EMPRESA&id=[id_emp]&cand=[num_cand]

Parâmetros
Parâmetro Valores Defeito Descrição
key CHAVE_DA_EMPRESA Obrigatório Chave de identificação da empresa fornecida pela Wincode
id decimal(16,6)id_emp ID do emprego (Filtro por emprego)
cand int(11)num_cand ID do candidato (Filtro por candidato)
Variáveis de Retorno
Nome Tipo Descrição
id_candi int(11) Id da candidatura
cand_candi int(11) Id da candidato
emp_candi deciamal(16,6) Id do emprego
data_candi datetime Data da candidatura
Informação do candidato
num_cand int(11) Id do candidato
nome_cand char(100) Nome do candidato
rua1_cand char(50) Primeira linha da morada
rua2_cand char(50) Segunda linha da morada
loca_cand char(50) Localidade do candidato
cpos_cand char(50) Código postal do candidato
dat_nas_cand datetime Data de nascimento do candidato
sexo_cand char(1) Sexo do candidato
est_civ_cand char(2) Código do estado civil do candidato
  • 1 [Solteiro]
  • 2 [Casado]
  • 3 [Viúvo]
  • 4 [Divorciado]
  • 5 [Casado Facto]
  • 6 [União Facto]
  • 99 [Outro]
desc_est_civil char(20) Descritivo do estado civil do candidato
cont_cand char(12) Número de contribuinte do candidato
cate_cand char(6) Código da categoria do candidato
prof_cand char(6) Código da profissão do candidato
nac_cand char(6) Código de nacionalidade do candidato
nome_nacio char(50) Descritivo da nacionalidade do candidato
des_cate char(50) Desrição da categoria do candidato
email_cand char(200) Email do candidato
email_cand char(200) Email do candidato
telf_cand char(80) Número de telefone do candidato
telm_cand char(80) Número de telemóvel candidato
Informação detalhada do candidato
ssocial_cident char(12) Número de segurança social do candidato
num_cc_cident char(12) Número de cartão de cidadão do candidato
arq_cc_cident char(10) Arquivo do cartão de cidadão do candidato
val_cc_cident datetime Validade do cartão de cidadão do candidato
num_pass_cident char(12) Número de passaporte do candidato
pai_pass_cident char(6) Código do país passaporte do candidato
dat_pass_cident datetime Data de emissão do passaporte do candidato
val_pass_cident datetime Data de validade do passaporte do candidato
autred_cident char(20) Número de autorização de residência
anex_apres_cident varchar(300) Nome do anexo da carta de apresentação
anexorg_apres_cident varchar(300) Nome original do anexo da carta de apresentação
anexlnk_apres_cident varchar(300) Endereço url para download do anexo da carta de apresentação
anex_cv_cident varchar(300) Nome do anexo do currículo
anexorg_cv_cident varchar(300) Nome original do anexo do currículo
anexlnk_cv_cident varchar(300) Endereço url para download do anexo do currículo
Línguas do candidato array
linguas[][cand_candlin] int(11) Código do candidato
linguas[][codlin_candlin] char(6) Código da língua
linguas[][des_ling] char(50) Descritivo da língua
linguas[][oral_candlin] int(11) Classificação oral da língua
linguas[][leitura_candlin] int(11) Classificação leitura da língua
linguas[][escrita_candlin] int(11) Classificação escrita da língua
linguas[][escrita_candlin] int(11) Classificação tradução da língua
Experiência profissional do candidato array
posicoes[][cand_candpos] int(11) Código do candidato
posicoes[][pos_candpos] char(100) Cargo
posicoes[][emp_candpos] char(50) Empresa
posicoes[][inicio_candpos] datetime Data de início da função
posicoes[][fim_candpos] datetime Data de fim de função
Informação do emprego
id_emp decimal(16,6) Identificação do emprego
ref_emp char(20) Referência do emprego
des_emp char(100) Descrição/título do emprego
local_emp char(120) Localização do emprego
aprov_emp datetime Data de publicação do emprego
inicio_emp datetime Data de início do emprego
funcoes_emp text Funções associadas ao emprego
anuncio_emp text Descrição completa do anúncio em formato html
vagas_emp int(11) Número de vagas disponíveis
carac_cliente_emp text Caracterização do cliente
carac_funcoes_emp text Descrição de funções
carac_requ_emp text Requisitos do emprego
carac_oferta_emp text Oferta
hotjob_emp int(1) HotJob
  • 0 [Não]
  • 1 [Sim]
entimediata_emp int(1) Entrada imediata
  • 0 [Não]
  • 1 [Sim]
Exemplo pelo método JSON

289 id_candi - Manuel José nome_cand
des_emp
Data de candidatura: 2024-07-29 09:46:01 data_candi Categoria do candidato: des_cate

290 id_candi - Manuel José nome_cand
1 vaga(s) para Pintor 1ª des_emp
Data de candidatura: 2024-07-29 10:18:26 data_candi Categoria do candidato: des_cate

293 id_candi - dsfdsfsdf nome_cand
des_emp
Data de candidatura: 2024-08-28 10:08:35 data_candi Categoria do candidato: des_cate

294 id_candi - sdffsdfds nome_cand
des_emp
Data de candidatura: 2024-08-28 10:09:45 data_candi Categoria do candidato: des_cate

295 id_candi - sdfsdfdsf nome_cand
des_emp
Data de candidatura: 2024-08-28 10:10:43 data_candi Categoria do candidato: des_cate

327 id_candi - Bruno Cardoso Sá Ferreira nome_cand
des_emp
Data de candidatura: 2024-10-11 10:16:54 data_candi Categoria do candidato: des_cate

330 id_candi - Tiago André da Silva Moutinho nome_cand
des_emp
Data de candidatura: 2024-10-14 11:50:23 data_candi Categoria do candidato: Ajudante des_cate

332 id_candi - Luis Guilherme Pereira Leitão Dias nome_cand
1 vaga(s) para Pintor 1ª des_emp
Data de candidatura: 2024-10-14 19:20:47 data_candi Categoria do candidato: des_cate

340 id_candi - Luis Guilherme Pereira Leitão Dias nome_cand
des_emp
Data de candidatura: 2024-10-14 19:28:37 data_candi Categoria do candidato: des_cate

342 id_candi - Vasco Manuel Concha Mendes nome_cand
des_emp
Data de candidatura: 2024-10-15 00:58:16 data_candi Categoria do candidato: des_cate

Lista de candidaturas por oferta de emprego pelo método POST
https://www.wportal.pt/api/candidaturas

Parâmetros
Parâmetro Valores Defeito Descrição
privatekey CHAVE_PRIVADA_DA_EMPRESA Chave de identificação privada da empresa fornecida pela Wincode. Esta chave é confidencial.
num_cand int() Opcional Filtrar por candidato
id_emp int() Opcional Filtrar por emprego
Variáveis de Retorno
Nome Tipo Descrição
Informação do serviço
status boolean (true,false) Resultado da operação
message string Mensagem de retorno do webservice
count string Quantidade de registos encontrados
Registos de candidaturas
rows[$i]["id_candi"] int(11) Id da candidatura
rows[$i]["cand_candi"] int(11) Id da candidato
rows[$i]["emp_candi"] deciamal(16,6) Id do emprego
rows[$i]["data_candi"] datetime Data da candidatura
Informação do candidato
rows[$i]["num_cand"] int(11) Id do candidato
rows[$i]["nome_cand"] char(100) Nome do candidato
rows[$i]["rua1_cand"] char(50) Primeira linha da morada
rows[$i]["rua2_cand"] char(50) Segunda linha da morada
rows[$i]["loca_cand"] char(50) Localidade do candidato
rows[$i]["cpos_cand"] char(50) Código postal do candidato
rows[$i]["dat_nas_cand"] datetime Data de nascimento do candidato
rows[$i]["sexo_cand"] char(1) Sexo do candidato
rows[$i]["est_civ_cand"] char(2) Código do estado civil do candidato
  • 1 [Solteiro]
  • 2 [Casado]
  • 3 [Viúvo]
  • 4 [Divorciado]
  • 5 [Casado Facto]
  • 6 [União Facto]
  • 99 [Outro]
rows[$i]["desc_est_civil"] char(20) Descritivo do estado civil do candidato
rows[$i]["cont_cand"] char(12) Número de contribuinte do candidato
rows[$i]["cate_cand"] char(6) Código da categoria do candidato
rows[$i]["prof_cand"] char(6) Código da profissão do candidato
rows[$i]["nac_cand"] char(6) Código de nacionalidade do candidato
rows[$i]["nome_nacio"] char(50) Descritivo da nacionalidade do candidato
rows[$i]["des_cate"] char(50) Desrição da categoria do candidato
rows[$i]["email_cand"] char(200) Email do candidato
rows[$i]["email_cand"] char(200) Email do candidato
rows[$i]["telf_cand"] char(80) Número de telefone do candidato
rows[$i]["telm_cand"] char(80) Número de telemóvel candidato
Informação detalhada do candidato
rows[$i]["ssocial_cident"] char(12) Número de segurança social do candidato
rows[$i]["num_cc_cident"] char(12) Número de cartão de cidadão do candidato
rows[$i]["arq_cc_cident"] char(10) Arquivo do cartão de cidadão do candidato
rows[$i]["val_cc_cident"] datetime Validade do cartão de cidadão do candidato
rows[$i]["num_pass_cident"] char(12) Número de passaporte do candidato
rows[$i]["pai_pass_cident"] char(6) Código do país passaporte do candidato
rows[$i]["dat_pass_cident"] datetime Data de emissão do passaporte do candidato
rows[$i]["val_pass_cident"] datetime Data de validade do passaporte do candidato
rows[$i]["autred_cident"] char(20) Número de autorização de residência
rows[$i]["anex_apres_cident"] varchar(300) Nome do anexo da carta de apresentação
rows[$i]["anexorg_apres_cident"] varchar(300) Nome original do anexo da carta de apresentação
rows[$i]["anexlnk_apres_cident"] varchar(300) Endereço url para download do anexo da carta de apresentação
rows[$i]["anex_cv_cident"] varchar(300) Nome do anexo do currículo
rows[$i]["anexorg_cv_cident"] varchar(300) Nome original do anexo do currículo
rows[$i]["anexlnk_cv_cident"] varchar(300) Endereço url para download do anexo do currículo
Línguas do candidato array
rows[$i]["linguas[][cand_candlin]"] int(11) Código do candidato
rows[$i]["linguas[][codlin_candlin]"] char(6) Código da língua
rows[$i]["linguas[][des_ling]"] char(50) Descritivo da língua
rows[$i]["linguas[][oral_candlin]"] int(11) Classificação oral da língua
rows[$i]["linguas[][leitura_candlin]"] int(11) Classificação leitura da língua
rows[$i]["linguas[][escrita_candlin]"] int(11) Classificação escrita da língua
rows[$i]["linguas[][escrita_candlin]"] int(11) Classificação tradução da língua
Experiência profissional do candidato array
rows[$i]["posicoes[][cand_candpos]"] int(11) Código do candidato
rows[$i]["posicoes[][pos_candpos]"] char(100) Cargo
rows[$i]["posicoes[][emp_candpos]"] char(50) Empresa
rows[$i]["posicoes[][inicio_candpos]"] datetime Data de início da função
rows[$i]["posicoes[][fim_candpos]"] datetime Data de fim de função
Informação do emprego
rows[$i]["id_emp"] decimal(16,6) Identificação do emprego
rows[$i]["ref_emp"] char(20) Referência do emprego
rows[$i]["des_emp"] char(100) Descrição/título do emprego
rows[$i]["local_emp"] char(120) Localização do emprego
rows[$i]["aprov_emp"] datetime Data de publicação do emprego
rows[$i]["inicio_emp"] datetime Data de início do emprego
rows[$i]["funcoes_emp"] text Funções associadas ao emprego
rows[$i]["anuncio_emp"] text Descrição completa do anúncio em formato html
rows[$i]["vagas_emp"] int(11) Número de vagas disponíveis
rows[$i]["carac_cliente_emp"] text Caracterização do cliente
rows[$i]["carac_funcoes_emp"] text Descrição de funções
rows[$i]["carac_requ_emp"] text Requisitos do emprego
rows[$i]["carac_oferta_emp"] text Oferta
rows[$i]["hotjob_emp"] int(1) HotJob
  • 0 [Não]
  • 1 [Sim]
rows[$i]["entimediata_emp"] int(1) Entrada imediata
  • 0 [Não]
  • 1 [Sim]
Exemplo pelo método POST
$data = array(
     'privatekey' => "CHAVE_PRIVADA_DA_EMPRESA",
     'num_cand'   => "999999999",
     'id_emp'    => ""
);

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

//submeter o webservice por CURL
$curl = curl_init("https://www.wportal.pt/api/candidaturas");
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"];