WXEQ (1.0.0)

Download OpenAPI specification:Download

Sistema WXEQ: sac@wxeq.com.br URL: https://wxeq.com.br License: Apache 2.0

Informações

Neste site demonstramos as funcionalidades da API WXEQ, dentre elas, autenticação, paginação, consulta com filtro, inserção e alteração de dados.

Paginação

O resultado da busca conterá no seu cabeçalho:

  • X-Pagination-Total-Count: Total de registros
  • X-Pagination-Page-Count: Total de páginas
  • X-Pagination-Current-Page: Índice da página atual
  • X-Pagination-Per-Page: Quantidade de registros por página

É possível definir qual o índice da página e quantidade de registros por página devem ser retornandos.

  • page: Índice da página
  • per-page: Quantidade de registros por página

Exemplo:

http://api.wxeq.com.br/v1/trajeto?page=2&per-page=30

Filtro

Em todas as requisições de listagem de dados é possível definir um filtro

{
  "or": [
    {
      "and": [
        {"descricao": "alguma descricao"},
        {"preco": 25.50}
      ]
    }, {
      "id": {"in": [2, 5, 9]},
      "preco": {"gt": 10, "lt": 50}
    }
  ]
}

Os possíveis operadores são:

  • lt: <
  • gt: >
  • lte: <=
  • gte: >=
  • eq: =
  • neq: diferente
  • in: contido
  • nin: não está contido
  • like: contendo

Exemplo:

http://api.wxeq.com.br/v1/trajeto?filtro={"id": {"in": [1]}}

Sumário

Em todas as requisições de listagem de dados é possível definir uma totalização sumário

[{
    selector: "numero",
    summaryType: "count"
  },
  {
    selector: "qtd",
    summaryType: "sum"
}]

Exemplo:

http://api.wxeq.com.br/v1/trajeto?totalSummary=[{selector: "numero",summaryType: "count"}]

Autenticação

Obtem informações do login.

No retorno conterá o campo token que deverá ser utilizado nas demais requisições como método de autenticação.

Os seguintes métodos de autenticação estão disponíveis:

  • JWT Tokens (Adicionar o Header Authentication com o valor Jwt <TOKEN>)
  • Chave API - Inativo
  • Basic Authentication - Inativo

Todas requisições deverão conter o token utilizando um método de autenticação

Login

path Parameters
username
required
string

Email de acesso

password
required
string

Senha de acesso

Responses

Response samples

Content type
application/json
Example
{
  • "success": true,
  • "message": "Login bem-sucedido, salve seu token",
  • "data": {
    }
}

Trajetos

Listar trajetos

query Parameters
page
integer

Verificar documentação da paginação

per-page
integer

Verificar documentação da paginação

filtro
string

Verificar documentação do filtro

summary
string

Verificar documentação dos sumário

Responses

Response samples

Content type
application/json
Example
{
  • "success": true,
  • "data": [
    ]
}

Obter trajeto

path Parameters
id
required
string

Identificador único

Responses

Response samples

Content type
application/json
Example
{
  • "sucesso": true,
  • "conteudo": {
    }
}

Avançar etapa

path Parameters
id
required
string

Identificador único

etapa_id
required
integer

Etapa atual do trajeto, informação contida no retorno do trajeto

Request Body schema: application/json
numero
string
datexpedicao
required
string
datjanela
string
transportador_id
required
integer
entidade_id
integer
entidade_id2
integer
entidade_id3
integer
motorista_id
integer
motorista_id2
integer
origem_id
required
integer
coleta_id
integer
plataforma_id
integer
unidade_id
integer
tipo_entidade_id
integer
numero_transporte
string
nf
string
datnf
string
ctrc
string
datctrc
string
balanca
number
balanca2
number
balanca_liquido
number
etapa_id
number

Parâmetro obrigatório para avançar etapa

Array of objects (schemas)
Array of objects (schemas)

Responses

Request samples

Content type
application/json
{
  • "numero": "string",
  • "datexpedicao": "string",
  • "datjanela": "string",
  • "transportador_id": 0,
  • "entidade_id": 0,
  • "entidade_id2": 0,
  • "entidade_id3": 0,
  • "motorista_id": 0,
  • "motorista_id2": 0,
  • "origem_id": 0,
  • "coleta_id": 0,
  • "plataforma_id": 0,
  • "unidade_id": 0,
  • "tipo_entidade_id": 0,
  • "numero_transporte": "string",
  • "nf": "string",
  • "datnf": "string",
  • "ctrc": "string",
  • "datctrc": "string",
  • "balanca": 0,
  • "balanca2": 0,
  • "balanca_liquido": 0,
  • "etapa_id": 0,
  • "entregas": [
    ],
  • "status": [
    ]
}

Response samples

Content type
application/json
Example
{
  • "sucesso": true,
  • "conteudo": {
    }
}

Excluir trajeto

path Parameters
id
required
string

Identificador único

Responses

Response samples

Content type
application/json
Example
{
  • "sucess": true
}

Cancelar trajeto

path Parameters
id
required
string

Identificador único

comunicar
required
string

Enviar email ao cancelar trajeto

Request Body schema: application/json
justificativa
string

Responses

Request samples

Content type
application/json
{
  • "justificativa": "string"
}

Response samples

Content type
application/json
Example
{
  • "sucesso": true,
  • "conteudo": {
    }
}

Voltar etapa anterior

path Parameters
id
required
string

Identificador único

comunicar
required
string

Enviar email ao cancelar trajeto

Responses

Response samples

Content type
application/json
Example
{
  • "sucesso": true,
  • "conteudo": {
    }
}

Checklist

Listar modelos de checklist

query Parameters
page
integer

Verificar documentação da paginação

per-page
integer

Verificar documentação da paginação

filtro
string

Verificar documentação do filtro

summary
string

Verificar documentação dos sumário

Responses

Response samples

Content type
application/json
Example
{
  • "success": true,
  • "data": [
    ]
}

Checklist Realizado

Listar checklist realizado

query Parameters
page
integer

Verificar documentação da paginação

per-page
integer

Verificar documentação da paginação

filtro
string

Verificar documentação do filtro

summary
string

Verificar documentação dos sumário

Responses

Response samples

Content type
application/json
Example
{
  • "success": true,
  • "data": [
    ]
}