Documentação - Tabela de Perfis

Introdução


 

A API Tabela de perfis tem por objetivo listar os perfis de origem, destino, natureza de operação e finalidade com suas respectivas descrições.

Acesso

Comunicação: REST/JSON

Para acessar a coleção de chamadas Clique Aqui.

Swagger API Tabela de Perfis
https://app.systax.com.br/auth/swagger#/tabela_perfis/findPerfis
 

Listagem do Endpoint que contempla o manual de Tabela de Perfis

Descrição

Grupo Swagger

Método

URL Endpoint

URL Token

Listagem da tabela de perfis

tabela_perfis

GET

https://app.systax.com.br/
tabelas/perfis

https://app.systax
.com.br/auth/
access-token

 

Autenticação

A autenticação da API mencionada neste documento podem ser feitas via usuário e senha ou bearer token. Consulte a tabela no item Acesso para saber qual URL utilizar. Para mais informações sobre o token - API - Gerar token.

Manual da API de geraç... | Systax Documentação

É necessário que o serviço dessa API esteja ativo no Site Systax.

Descrição dos campos de chamada e retorno

Objetivo: Identificar o cliente ou parceiro ao enviar a consulta de acordo com autenticação.

Descrição dos filtros que poderão ser utilizados na chamada:

Campo Definição Tipo Campo obrigatório
tabela

Indica a tabela onde será pesquisado o ID informado

1 = perfilOrigem

2 = perfilDestino

3 = Natureza

4 = Finalidade

OBS: Campo não pode ser em lista.

Integer Sim
id

ID do perfil a ser pesquisado nas tabelas

OBS: Campo pode ser em lista.

String Não
limit Máximo de itens a ser retornado por página. Default = 100 Integer Não
offset Define a posição inicial da paginação. Default = 1 Integer Não


Tabela de referência para o campo "success" e "message":

Código Sucess Message Descrição
200 Retorno com Sucesso

OK

Consulta realizada com sucesso
400 token_invalid Bad Request Token inválido
400 token_expired Bad Request Token expirado
500 internal_error Internal server erro Erro interno


Descrição dos campos de retorno:

Campo Tipo Formato Descrição
message String   Retorna se a consulta foi realizada com sucesso ou não
tabela String   Nome da tabela em que foi pesquisado
recor_count Integer   Quantidade de registros retornados
id Integer ($int32) ID do perfil pesquisado
descrição String   Descrição do perfil pesquisado

 

 


 

Exemplo de Chamada

https://app.systax.com.br/tabelas/perfis?tabela=1&id=1,2

Exemplo de Retorno

{
    "success": true,
    "message": "ok",
    "tabela": "perfilOrigem",
    "record_count": 2,
    "items": [
        {
            "id": 1,
            "descricao": "Indústria"
        },
        {
            "id": 2,
            "descricao": "Atacadista"
        }
    ]
}