glcalil-ufg
commented
2 years ago @umarley
post:
tags:
- motoristas
summary: Cadastrar um novo motorista no sistema SETE
operationId: newMotorista
consumes:
- application/json
produces:
- application/json
parameters:
- in: path
name: codigo_cidade
description: Código do municipio que o motorista pertence
required: true
type: integer
- in: body
name: body
description: Objeto contendo os dados do motorista
required: true
schema:
$ref: '#/definitions/Motorista'
responses:
201:
description: Operacão realizada com sucesso
schema:
$ref: '#/definitions/CreateResponseCPF'
400:
description: Parâmetros invalidos
404:
description: Não encontrado
security:
- api_key: []Modelo Response
CreateResponseCPF:
type: object
properties:
result:
type: boolean
messages:
type: array
items:
type: object
properties:
cpf:
type: string
description: cpf objeto a ser registrado
Exemplo de requisição:
POST https://sete.transportesufg.eng.br/motoristas/5201405
Path:
codigo_cidade: 5201405
Body:
Resultado do experimento:
Retorno do HTTP está 200 (OK)
O resultado está diferente do esperado na API
Está usando o seguinte formato
{ result: "true", messages: “...” }
Exemplo de requisição:
POST https://sete.transportesufg.eng.br/motoristas/5201405
1 - Campos inválidos;
2 - Codigo cidade errado;
3 - Campo data_validade_cnh vazio
Resultado do experimento:
Retorno do HTTP está 400 (BAD REQUEST)
O resultado está diferente do esperado na API
Está usando o seguinte formato
{ result: "false", messages : “...” }
No caso 1 existem erros não capturados
Dificuldades ao cadastrar um motorista, formato dos dados indicados na documentação API não estão coerentes com o esperado pela API real
Exemplo a data_validade_cnh que está como não obrigatória caso 3