A maior base de documentação de GSAN do mercado mantida pela Consenso Tecnologia
Aqui você vê as diferenças entre duas revisões dessa página.
— |
integracoes:web-services-listar-dias-vencimento-alternativo [12/12/2019 18:24] (atual) tadeu.sarmento criada |
||
---|---|---|---|
Linha 1: | Linha 1: | ||
+ | {{ajuda:logo-gsan3.png?90|}} | ||
+ | |||
+ | ====== WebService Listar Dias de Vencimento Alternativo ====== | ||
+ | |||
+ | <columns> | ||
+ | O WebService recebe apenas requisições do tipo **GET**, e os parâmetros são passados via **Query Parameter**. | ||
+ | |||
+ | Ele espera os seguintes Parâmetros: | ||
+ | - key, //String// contendo a chave de autenticação da empresa. | ||
+ | - matrícula, //String// contendo a matrícula que será usada como filtro. | ||
+ | </columns> | ||
+ | \\ | ||
+ | |||
+ | ===== Exemplo de requisição para o sistema ===== | ||
+ | |||
+ | Com as seguintes informações: | ||
+ | |IP|192.168.64.111| | ||
+ | |Chave de autenticação|aBC123DEF| | ||
+ | |Matrícula|5101433| | ||
+ | |||
+ | \\ | ||
+ | |||
+ | ===== A Requisição Seria ===== | ||
+ | |||
+ | http://192.168.64.111:8080/gsan/listarDiasVencimentoWs?key=aBC123DEF&matricula=5101433 | ||
+ | |||
+ | \\ | ||
+ | |||
+ | ===== Retorno em Caso de Sucesso ===== | ||
+ | <code javascript> | ||
+ | { | ||
+ | "key": (String) chave de autenticação recebida pelo WebService, | ||
+ | "qtd": (Integer) quantidade de dias que estão sendo retornados, | ||
+ | "resultado": [ List<Integer> contendo os dias específicos.] | ||
+ | } | ||
+ | |||
+ | </code> | ||
+ | \\ | ||
+ | |||
+ | **Exemplo**: | ||
+ | |||
+ | <WRAP center round box 100%> | ||
+ | {{ :integracoes:listar_dias_vencimento_json_1.jpg?nolink |}} | ||
+ | </WRAP> | ||
+ | |||
+ | \\ | ||
+ | |||
+ | ===== Retorno em Caso de erro ===== | ||
+ | <code javascript> | ||
+ | { | ||
+ | "error": (Integer) Código de erro da requisição, | ||
+ | "msg": (String) Mensagem indicando o que houve, ou vazio em caso de erro 500, | ||
+ | "qtd": (Integer) sempre valor 0 | ||
+ | } | ||
+ | </code> | ||
+ | |||
+ | **Exemplo**: | ||
+ | |||
+ | \\ | ||
+ | <WRAP center round box 100%> | ||
+ | {{ :integracoes:acomp_ra_json_2.jpg?nolink |}} | ||
+ | </WRAP> | ||
+ | |||
+ | \\ | ||
+ | |||
+ | ===== Possíveis Códigos de Retorno ===== | ||
+ | |Código|Mensagem| | ||
+ | |400|"parâmetros inválidos"| | ||
+ | |401|"chave inválida"| | ||
+ | |404|"A consulta não trouxe resultados"| | ||
+ | |500|“”| | ||
+ | \\ | ||
+ | |||
+ | Clique **[[=treinamentos:integracoes|AQUI]]** para acessar outros serviços com os detalhes técnicos das integrações. |