|
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707 |
- # As found on https://petstore.swagger.io, August 2018
- ---
- swagger: '2.0'
- info:
- description: 'This is a sample server Petstore server. You can find out more about
- Swagger at [http://swagger.io](http://swagger.io) or on [irc.freenode.net, #swagger](http://swagger.io/irc/). For
- this sample, you can use the api key `special-key` to test the authorization filters.'
- version: 1.0.0
- title: Swagger Petstore
- termsOfService: http://swagger.io/terms/
- contact:
- email: apiteam@swagger.io
- license:
- name: Apache 2.0
- url: http://www.apache.org/licenses/LICENSE-2.0.html
- host: petstore.swagger.io
- basePath: "/v2"
- tags:
- - name: pet
- description: Everything about your Pets
- externalDocs:
- description: Find out more
- url: http://swagger.io
- - name: store
- description: Access to Petstore orders
- - name: user
- description: Operations about user
- externalDocs:
- description: Find out more about our store
- url: http://swagger.io
- schemes:
- - https
- - http
- paths:
- "/pet":
- post:
- tags:
- - pet
- summary: Add a new pet to the store
- description: ''
- operationId: addPet
- consumes:
- - application/json
- - application/xml
- produces:
- - application/xml
- - application/json
- parameters:
- - in: body
- name: body
- description: Pet object that needs to be added to the store
- required: true
- schema:
- "$ref": "#/definitions/Pet"
- responses:
- '405':
- description: Invalid input
- security:
- - petstore_auth:
- - write:pets
- - read:pets
- put:
- tags:
- - pet
- summary: Update an existing pet
- description: ''
- operationId: updatePet
- consumes:
- - application/json
- - application/xml
- produces:
- - application/xml
- - application/json
- parameters:
- - in: body
- name: body
- description: Pet object that needs to be added to the store
- required: true
- schema:
- "$ref": "#/definitions/Pet"
- responses:
- '400':
- description: Invalid ID supplied
- '404':
- description: Pet not found
- '405':
- description: Validation exception
- security:
- - petstore_auth:
- - write:pets
- - read:pets
- "/pet/findByStatus":
- get:
- tags:
- - pet
- summary: Finds Pets by status
- description: Multiple status values can be provided with comma separated strings
- operationId: findPetsByStatus
- produces:
- - application/xml
- - application/json
- parameters:
- - name: status
- in: query
- description: Status values that need to be considered for filter
- required: true
- type: array
- items:
- type: string
- enum:
- - available
- - pending
- - sold
- default: available
- collectionFormat: multi
- responses:
- '200':
- description: successful operation
- schema:
- type: array
- items:
- "$ref": "#/definitions/Pet"
- '400':
- description: Invalid status value
- security:
- - petstore_auth:
- - write:pets
- - read:pets
- "/pet/findByTags":
- get:
- tags:
- - pet
- summary: Finds Pets by tags
- description: Muliple tags can be provided with comma separated strings. Use
- tag1, tag2, tag3 for testing.
- operationId: findPetsByTags
- produces:
- - application/xml
- - application/json
- parameters:
- - name: tags
- in: query
- description: Tags to filter by
- required: true
- type: array
- items:
- type: string
- collectionFormat: multi
- responses:
- '200':
- description: successful operation
- schema:
- type: array
- items:
- "$ref": "#/definitions/Pet"
- '400':
- description: Invalid tag value
- security:
- - petstore_auth:
- - write:pets
- - read:pets
- deprecated: true
- "/pet/{petId}":
- get:
- tags:
- - pet
- summary: Find pet by ID
- description: Returns a single pet
- operationId: getPetById
- produces:
- - application/xml
- - application/json
- parameters:
- - name: petId
- in: path
- description: ID of pet to return
- required: true
- type: integer
- format: int64
- responses:
- '200':
- description: successful operation
- schema:
- "$ref": "#/definitions/Pet"
- '400':
- description: Invalid ID supplied
- '404':
- description: Pet not found
- security:
- - api_key: []
- post:
- tags:
- - pet
- summary: Updates a pet in the store with form data
- description: ''
- operationId: updatePetWithForm
- consumes:
- - application/x-www-form-urlencoded
- produces:
- - application/xml
- - application/json
- parameters:
- - name: petId
- in: path
- description: ID of pet that needs to be updated
- required: true
- type: integer
- format: int64
- - name: name
- in: formData
- description: Updated name of the pet
- required: false
- type: string
- - name: status
- in: formData
- description: Updated status of the pet
- required: false
- type: string
- responses:
- '405':
- description: Invalid input
- security:
- - petstore_auth:
- - write:pets
- - read:pets
- delete:
- tags:
- - pet
- summary: Deletes a pet
- description: ''
- operationId: deletePet
- produces:
- - application/xml
- - application/json
- parameters:
- - name: api_key
- in: header
- required: false
- type: string
- - name: petId
- in: path
- description: Pet id to delete
- required: true
- type: integer
- format: int64
- responses:
- '400':
- description: Invalid ID supplied
- '404':
- description: Pet not found
- security:
- - petstore_auth:
- - write:pets
- - read:pets
- "/pet/{petId}/uploadImage":
- post:
- tags:
- - pet
- summary: uploads an image
- description: ''
- operationId: uploadFile
- consumes:
- - multipart/form-data
- produces:
- - application/json
- parameters:
- - name: petId
- in: path
- description: ID of pet to update
- required: true
- type: integer
- format: int64
- - name: additionalMetadata
- in: formData
- description: Additional data to pass to server
- required: false
- type: string
- - name: file
- in: formData
- description: file to upload
- required: false
- type: file
- responses:
- '200':
- description: successful operation
- schema:
- "$ref": "#/definitions/ApiResponse"
- security:
- - petstore_auth:
- - write:pets
- - read:pets
- "/store/inventory":
- get:
- tags:
- - store
- summary: Returns pet inventories by status
- description: Returns a map of status codes to quantities
- operationId: getInventory
- produces:
- - application/json
- parameters: []
- responses:
- '200':
- description: successful operation
- schema:
- type: object
- additionalProperties:
- type: integer
- format: int32
- security:
- - api_key: []
- "/store/order":
- post:
- tags:
- - store
- summary: Place an order for a pet
- description: ''
- operationId: placeOrder
- produces:
- - application/xml
- - application/json
- parameters:
- - in: body
- name: body
- description: order placed for purchasing the pet
- required: true
- schema:
- "$ref": "#/definitions/Order"
- responses:
- '200':
- description: successful operation
- schema:
- "$ref": "#/definitions/Order"
- '400':
- description: Invalid Order
- "/store/order/{orderId}":
- get:
- tags:
- - store
- summary: Find purchase order by ID
- description: For valid response try integer IDs with value >= 1 and <= 10. Other
- values will generated exceptions
- operationId: getOrderById
- produces:
- - application/xml
- - application/json
- parameters:
- - name: orderId
- in: path
- description: ID of pet that needs to be fetched
- required: true
- type: integer
- maximum: 10
- minimum: 1
- format: int64
- responses:
- '200':
- description: successful operation
- schema:
- "$ref": "#/definitions/Order"
- '400':
- description: Invalid ID supplied
- '404':
- description: Order not found
- delete:
- tags:
- - store
- summary: Delete purchase order by ID
- description: For valid response try integer IDs with positive integer value.
- Negative or non-integer values will generate API errors
- operationId: deleteOrder
- produces:
- - application/xml
- - application/json
- parameters:
- - name: orderId
- in: path
- description: ID of the order that needs to be deleted
- required: true
- type: integer
- minimum: 1
- format: int64
- responses:
- '400':
- description: Invalid ID supplied
- '404':
- description: Order not found
- "/user":
- post:
- tags:
- - user
- summary: Create user
- description: This can only be done by the logged in user.
- operationId: createUser
- produces:
- - application/xml
- - application/json
- parameters:
- - in: body
- name: body
- description: Created user object
- required: true
- schema:
- "$ref": "#/definitions/User"
- responses:
- default:
- description: successful operation
- "/user/createWithArray":
- post:
- tags:
- - user
- summary: Creates list of users with given input array
- description: ''
- operationId: createUsersWithArrayInput
- produces:
- - application/xml
- - application/json
- parameters:
- - in: body
- name: body
- description: List of user object
- required: true
- schema:
- type: array
- items:
- "$ref": "#/definitions/User"
- responses:
- default:
- description: successful operation
- "/user/createWithList":
- post:
- tags:
- - user
- summary: Creates list of users with given input array
- description: ''
- operationId: createUsersWithListInput
- produces:
- - application/xml
- - application/json
- parameters:
- - in: body
- name: body
- description: List of user object
- required: true
- schema:
- type: array
- items:
- "$ref": "#/definitions/User"
- responses:
- default:
- description: successful operation
- "/user/login":
- get:
- tags:
- - user
- summary: Logs user into the system
- description: ''
- operationId: loginUser
- produces:
- - application/xml
- - application/json
- parameters:
- - name: username
- in: query
- description: The user name for login
- required: true
- type: string
- - name: password
- in: query
- description: The password for login in clear text
- required: true
- type: string
- responses:
- '200':
- description: successful operation
- schema:
- type: string
- headers:
- X-Rate-Limit:
- type: integer
- format: int32
- description: calls per hour allowed by the user
- X-Expires-After:
- type: string
- format: date-time
- description: date in UTC when token expires
- '400':
- description: Invalid username/password supplied
- "/user/logout":
- get:
- tags:
- - user
- summary: Logs out current logged in user session
- description: ''
- operationId: logoutUser
- produces:
- - application/xml
- - application/json
- parameters: []
- responses:
- default:
- description: successful operation
- "/user/{username}":
- get:
- tags:
- - user
- summary: Get user by user name
- description: ''
- operationId: getUserByName
- produces:
- - application/xml
- - application/json
- parameters:
- - name: username
- in: path
- description: 'The name that needs to be fetched. Use user1 for testing. '
- required: true
- type: string
- responses:
- '200':
- description: successful operation
- schema:
- "$ref": "#/definitions/User"
- '400':
- description: Invalid username supplied
- '404':
- description: User not found
- put:
- tags:
- - user
- summary: Updated user
- description: This can only be done by the logged in user.
- operationId: updateUser
- produces:
- - application/xml
- - application/json
- parameters:
- - name: username
- in: path
- description: name that need to be updated
- required: true
- type: string
- - in: body
- name: body
- description: Updated user object
- required: true
- schema:
- "$ref": "#/definitions/User"
- responses:
- '400':
- description: Invalid user supplied
- '404':
- description: User not found
- delete:
- tags:
- - user
- summary: Delete user
- description: This can only be done by the logged in user.
- operationId: deleteUser
- produces:
- - application/xml
- - application/json
- parameters:
- - name: username
- in: path
- description: The name that needs to be deleted
- required: true
- type: string
- responses:
- '400':
- description: Invalid username supplied
- '404':
- description: User not found
- securityDefinitions:
- petstore_auth:
- type: oauth2
- authorizationUrl: https://petstore.swagger.io/oauth/dialog
- flow: implicit
- scopes:
- write:pets: modify pets in your account
- read:pets: read your pets
- api_key:
- type: apiKey
- name: api_key
- in: header
- definitions:
- Order:
- type: object
- properties:
- id:
- type: integer
- format: int64
- petId:
- type: integer
- format: int64
- quantity:
- type: integer
- format: int32
- shipDate:
- type: string
- format: date-time
- status:
- type: string
- description: Order Status
- enum:
- - placed
- - approved
- - delivered
- complete:
- type: boolean
- default: false
- xml:
- name: Order
- User:
- type: object
- properties:
- id:
- type: integer
- format: int64
- username:
- type: string
- firstName:
- type: string
- lastName:
- type: string
- email:
- type: string
- password:
- type: string
- phone:
- type: string
- userStatus:
- type: integer
- format: int32
- description: User Status
- xml:
- name: User
- Category:
- type: object
- properties:
- id:
- type: integer
- format: int64
- name:
- type: string
- xml:
- name: Category
- Tag:
- type: object
- properties:
- id:
- type: integer
- format: int64
- name:
- type: string
- xml:
- name: Tag
- Pet:
- type: object
- required:
- - name
- - photoUrls
- properties:
- id:
- type: integer
- format: int64
- category:
- "$ref": "#/definitions/Category"
- name:
- type: string
- example: doggie
- photoUrls:
- type: array
- xml:
- name: photoUrl
- wrapped: true
- items:
- type: string
- tags:
- type: array
- xml:
- name: tag
- wrapped: true
- items:
- "$ref": "#/definitions/Tag"
- status:
- type: string
- description: pet status in the store
- enum:
- - available
- - pending
- - sold
- xml:
- name: Pet
- ApiResponse:
- type: object
- properties:
- code:
- type: integer
- format: int32
- type:
- type: string
- message:
- type: string
- externalDocs:
- description: Find out more about Swagger
- url: http://swagger.io
|