umarley / seteAPI

BSD 3-Clause "New" or "Revised" License
2 stars 0 forks source link

Módulo Rotas - POST - Incluir um veículo para a rota #173

Open glcalil-ufg opened 2 years ago

glcalil-ufg commented 2 years ago


Exemplo de requisição:

POST https://sete.transportesufg.eng.br/rotas/5201405/73170/veiculos

Path:

codigo_cidade: 5201405

id_rota: 73170

Body:


Resultado do experimento:

  • Retorno do HTTP está 201 (CREATED)

  • O resultado está diferente do esperado na API

  • Está usando o seguinte formato 

{ result: "false", messages : “...” }



Exemplo de requisição:

POST https://sete.transportesufg.eng.br/rotas/5201405/73170/veiculos

1 - Campo vazio;

2 - Codigo cidade errado;

3 - Rota já possui um veículo

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



glcalil-ufg commented 2 years ago

@umarley

post:
      tags:
      - rotas
      summary: Incluir um veículo para a rota
      operationId: incluirVeiculoByRota
      consumes:
      - application/json
      produces:
      - application/json
      parameters:
      - in: path
        name: codigo_cidade
        description: Código do municipio que a rota pertence
        required: true
        type: integer
      - in: path
        name: id_rota
        description: ID da rota que se deseja incluir o veículo 
        required: true
        type: integer
      - in: body
        name: body
        description: Objeto contendo os dados do veículo
        required: true
        schema:
          type: object
          properties:
            id_veiculo: 
              type: integer
      responses:
        201:
          description: Operação realizada com sucesso
          schema:
            $ref: "#/definitions/CreateResponse"
        400:
          description: Parâmetros incorretos
        404:
          description: Não encontrado
      security:
      - api_key: []