umarley / seteAPI

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

Módulo Usuários - GET - Obter os dados de um usuário específico #96

Closed nataliasou closed 1 year ago

nataliasou commented 2 years ago

image Exemplo de requisição: GET https://sete.transportesufg.eng.br/users/sete/5201405/3920 Resultado: • Retorno do HTTP está 200 (OK) • O resultado está diferente do esperado na API • Está usando o seguinte formato { ..., “total”: 0, result: "true" } • Os últimos quatro campos de cada usuário estão como NULL, verificar se é o correto com o Prof. Marcos e o Umarley image Exemplo de requisição: GET https://sete.transportesufg.eng.br/users/sete/5201405/0 Resultado: • Retorno do HTTP está 200 (OK) • O resultado está diferente do esperado na API • Está usando o seguinte formato {result: "true" } • O resultado retorna apenas true quando o id dado não existe image Exemplo de requisição: GET https://sete.transportesufg.eng.br/users/sete/0/3920 Resultado: • Retorno do HTTP é 403 - Forbidden • A documentação não descreve como espera esse resultado • Está usando o seguinte formato {result: "false", “messages”: “string” } image Exemplo de requisição: GET https://sete.transportesufg.eng.br/users/ste/5201405/3920 Resultado: • Retorno do HTTP é 404 – Not found • Não possui esse tipo de resultado na documentação • Está usando o seguinte formato diferente dos outros com quatro campos e um link, verificar se isso está correto com o professor. image

nataliasou commented 2 years ago

@umarley

get:
      tags:
      - usuarios
      summary: Obter os dados de um usuário especifico
      operationId: getUser
      produces:
      - application/json
      parameters:
      - name: codigo_cidade
        in: path
        description: Código do município
        required: true
        type: integer
      - name: id_usuario
        in: path
        description: ID do usuário que se deseja consultar
        required: true
        type: integer
      responses:
        200:
          description: Operação realizada com sucesso
          schema:
              $ref: '#/definitions/DadosUsuario'
        400:
          description: Parâmetros incorretos.
        403:
          description: Usuário sem permissão para acessar o município selecionado.
        404:
          description: Recurso não encontrado.
      security:
      - api_key: []
umarley commented 1 year ago

API e documentação atualizadas.