Documentação - Tabela de Perfis
- Introdução
- Acesso
- Autenticação
- Descrição dos campos de chamada e retorno
- Exemplo de Chamada
- Exemplo de Retorno
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 |
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"
}
]
}