Serviço externo padrão MentorWeb - Retornar foto de uma pessoa

Esse serviço externo do MentorWeb retorna a foto de uma pessoa, em forma de array de bytes.
Para saber mais sobre serviços externos clique aqui.

Nome do serviço externo: foto

1. Parâmetros para chamada do serviço externo

Parâmetro Descrição Obrigatório Tipo Observação
pessoaCodigo Código da pessoa Sim String Informar o código de tela da pessoa
token Deve-se passar no cabeçalho da requisição o parâmetro token. O valor deste parâmetro é gerado pelo serviço de geração de token.


2. Exemplo de chamada do Serviço

URL: http://IP:PORTA/APLICACAO/rest/servicoexterno/execute/foto

2.1. Exemplo da passagem de parâmetros por Json:

{
  "pessoaCodigo" : "1011791"
}
2.2. Exemplo de chamada do serviço no PostMan

Gerando o token

Chamado o serviço de recuperação de foto

3. Retorno do serviço (Json)



Para obter o retorno do serviço deve-se verificar o status da requisição http. Sempre que o status for 200, significa que o processo foi realizado com sucesso.

3.1. Atributos retornados do serviço para o chamador

Campo Descrição Tipo Observação
resultado Retorna o resultado da consulta String SUCESSO ou ERRO, por exemplo.
dados Retorna um array de bytes que é a foto da pessoa Array de bytes


Exemplo de retorno Json:

[
    {
        "resultado": "SUCESSO",
        "dados": [
            {
                "pessoaId": 272523,
                "pessoaCodigo": "1011791",
                "pessoaNome": "Paola Alves Ponciano",
                "fotoTipo": "image/png",
                "fotoNome": "7968399hLWXRQctRjRe.png",
                "fotoBytes": [
                    -119,
                    80,
                    78,
                    71,
                    ........
                ]
            }
        ]
    }
]

Atenção: Caso a pessoa não seja encontrada, irá retornar sucesso, pois ocorreu sucesso na consulta, porém, o parâmetro de dados não será retornado.

  • (edição externa)