Consulta de Usuários
O objetivo dessa API é realizar a consulta de todos os usuários cadastrados na empresa filha desejada.
Acesso
URL: https://app.systax.com.br/partner/users/{child_client_id}
Método: GET
Importante: No lugar do {child_client_id} será informado o ID da empresa filha na qual os usuários cadastrados serão consultados
Descrição dos campos da chamada e retorno
Chamada
Essa API não possui corpo de chamada, portanto a única informação necessária é o token gerado e o ID da empresa filha na qual a consulta será feita, que é informado na própria URL, conforme exemplo abaixo:
Retorno
|
Tag |
Descrição |
|
id |
Informa o id que foi gerado no momento da criação do usuário. É o código único de identificação dele |
|
username |
É o usuário que foi cadastrado e que é utilizado como credencial de acesso no uso das API's |
|
nome |
Nome do usuário cadastrado |
|
|
Email do usuário cadastrado |
|
tipo |
Indica o nível de acesso para o usuário que está sendo criado. |
Códigos de retorno
|
Código de retorno |
Sucess |
Message |
Descrição |
|
200 |
true |
ok |
Consulta efetuada com sucesso |
|
400 |
false |
missing_token |
Token não informado |
|
400 |
false |
token_invalid |
Token informado está incorreto ou expirou |
|
400 |
false |
empresa xxx não é filha do parceiro ou não existe |
O ID Cliente informado na URL não existe ou não é filho do parceiro |
Exemplo de retorno
{
"success": true,
"message": "ok",
"record_count": 5,
"data": [
{
"id": 1,
"username": "empresa.teste1",
"nome": " Empresa Teste 1",
"email": "empresa.teste1@systax.com.br",
"tipo": 20
},
{
"id": 2,
"username": "empresa.teste2",
"nome": "Empresa Teste 2",
"email": "empresa.teste2@systax.com.br",
"tipo": 20
},
{
"id": 3,
"username": "empresa.teste3",
"nome": "Empresa Teste 3",
"email": "empresa.teste3@systax.com.br",
"tipo": 10
},
{
"id": 4,
"username": "empresa.teste4",
"nome": "Empresa Teste 4",
"email": "empresa.teste4@systax.com.br",
"tipo": 10
},
{
"id": 5,
"username": "empresa.teste5",
"nome": "Empresa Teste 5",
"email": "empresa.teste5@systax.com.br",
"tipo": 10
}
]
}