get_city_by_id.yml

Return an specific city
---
tags:
- name: Cities
description: A JSON object of city
produces:
  - application/json
parameters:
  - in: header
    name: Authorization
    type: string
    required: true
    description: Access token
  - in: path
    name: city_id
    type: integer
    required: true
security:
- jwtAuth: []
responses:
  200:
    description: Successful operation
    schema:
      type: object
      properties:
        key:
          type: string
        value:
          type: object
          properties:
            key:
              type: string
            value:
              type: string
      example:
        {city: {id: 22, name: Punta del Este, country: 15}}
  400:
    description: Missing or invalid parameters
  401:
    description: Unauthorized
  403:
    description: Access denied
  404:
    description: Information not found
  500:
    description: Server error

securityDefinitions:
  jwtAuth:
    type: oauth2
    flow: implicit
    scopes:
      write:restaurants: modify restaurants in your account
      read:restaurants: read public restaurants and in your account