v1.0.0

Swagger Petstore

My lovely API

This is a sample server Petstore server.
You can find out more about Swagger at
http://swagger.io or on irc.freenode.net, #swagger.
For this sample, you can use the api key special-key to test the authorization filters.

Introduction

This API is documented in OpenAPI format and is based on
Petstore sample provided by swagger.io team.
It was extended to illustrate features of generator-openapi-repo
tool and ReDoc documentation. In addition to standard
OpenAPI syntax we use a few vendor extensions.

OpenAPI Specification

Cross-Origin Resource Sharing

This API features Cross-Origin Resource Sharing (CORS) implemented in compliance with W3C spec.
And that allows cross-domain communication from the browser.
All responses have a wildcard same-origin which makes them completely public and accessible to everyone, including any code on any site.

Authentication

Petstore offers two forms of authentication:

API Key
OAuth2
OAuth2 - an open protocol to allow secure authorization in a simple
and standard method from web, mobile and desktop applications.

Contact

API Support/apiteam@swagger.io

Terms of Service

http://swagger.io/terms/

License

Apache 2.0

External Documentation

Find out how to create Github repo for your OpenAPI spec.

Servers

//petstore.swagger.io/v2Default server

//petstore.swagger.io/sandboxSandbox server

pet

Everything about your Pets

Operations

GET/pet POST/pet PUT/pet DELETE/pet GET/pet/{petId}POST/pet/{petId}DELETE/pet/{petId}POST/pet/{petId}/uploadImage GET/pet/findByStatus GET/pet/findByTags

ID: delete\PetById

OperationId with backslash

pet

GET

/pet

GET

/pet

Samples

cURLJavaScriptPHPPython

cURL

curl http://localhost/pet \
  --header 'Content-Type: application/json'

JavaScript

fetch('http://localhost/pet', {
  headers: {
    'Content-Type': 'application/json'
  }
})

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://localhost/pet",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Python

import requests

url = "http://localhost/pet"

headers = {"Content-Type": "application/json"}

response = requests.get(url, headers=headers)

print(response.json())

ID: addPet

Add a new pet to the store

pet

POST

/pet

Add new pet to the store inventory.

Authorizations

petstore_auth

Get access to data while protecting your account credentials.
OAuth2 is also a safer and more secure way to give you access.

implicit Flow

Authorization URLhttp://petstore.swagger.io/api/oauth/dialog

Scopes:

write:petsmodify pets in your account
read:petsread your pets

Request Body

JSON

{

"id": 0,

"category": {

"id": 0,

"name": "string",

"sub": {

"prop1": "string"

}

"name": "Guru",

"photoUrls": [

"friend": "[Circular Reference]",

"tags": [

{

"id": 0,

"name": "string"

}

"status": "string",

"petType": "string",

"huntingSkill": {

}

Responses

Invalid input

POST

/pet

Samples

cURLJavaScriptPHPPython

cURL

curl http://localhost/pet \
  --request POST \
  --header 'Authorization: Bearer petstore_auth' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 0,
  "category": {
    "id": 0,
    "name": "string",
    "sub": {
      "prop1": "string"
    }
  },
  "name": "Guru",
  "photoUrls": [],
  "friend": "[Circular Reference]",
  "tags": [
    {
      "id": 0,
      "name": "string"
    }
  ],
  "status": "string",
  "petType": "string",
  "huntingSkill": {}
}'

JavaScript

fetch('http://localhost/pet', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer petstore_auth',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    id: 0,
    category: {
      id: 0,
      name: 'string',
      sub: {
        prop1: 'string'
      }
    },
    name: 'Guru',
    photoUrls: [],
    friend: '[Circular Reference]',
    tags: [{
      id: 0,
      name: 'string'
    }],
    status: 'string',
    petType: 'string',
    huntingSkill: {
  
    }
  })
})

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://localhost/pet",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'id' => 0,
    'category' => [
        'id' => 0,
        'name' => 'string',
        'sub' => [
                'prop1' => 'string'
        ]
    ],
    'name' => 'Guru',
    'photoUrls' => [
        
    ],
    'friend' => '[Circular Reference]',
    'tags' => [
        [
                'id' => 0,
                'name' => 'string'
        ]
    ],
    'status' => 'string',
    'petType' => 'string',
    'huntingSkill' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer petstore_auth",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Python

import requests

url = "http://localhost/pet"

payload = {
    "id": 0,
    "category": {
        "id": 0,
        "name": "string",
        "sub": { "prop1": "string" }
    },
    "name": "Guru",
    "photoUrls": [],
    "friend": "[Circular Reference]",
    "tags": [
        {
            "id": 0,
            "name": "string"
        }
    ],
    "status": "string",
    "petType": "string",
    "huntingSkill": {}
}
headers = {
    "Authorization": "Bearer petstore_auth",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

ID: updatePet

Update an existing pet

pet

PUT

/pet

Authorizations

petstore_auth

Get access to data while protecting your account credentials.
OAuth2 is also a safer and more secure way to give you access.

implicit Flow

Authorization URLhttp://petstore.swagger.io/api/oauth/dialog

Scopes:

write:petsmodify pets in your account
read:petsread your pets

Request Body

JSON

{

"id": 0,

"category": {

"id": 0,

"name": "string",

"sub": {

"prop1": "string"

}

"name": "Guru",

"photoUrls": [

"friend": "[Circular Reference]",

"tags": [

{

"id": 0,

"name": "string"

}

"status": "string",

"petType": "string",

"huntingSkill": {

}

Responses

Invalid ID supplied

PUT

/pet

Samples

cURLJavaScriptPHPPython

cURL

curl http://localhost/pet \
  --request PUT \
  --header 'Authorization: Bearer petstore_auth' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 0,
  "category": {
    "id": 0,
    "name": "string",
    "sub": {
      "prop1": "string"
    }
  },
  "name": "Guru",
  "photoUrls": [],
  "friend": "[Circular Reference]",
  "tags": [
    {
      "id": 0,
      "name": "string"
    }
  ],
  "status": "string",
  "petType": "string",
  "huntingSkill": {}
}'

JavaScript

fetch('http://localhost/pet', {
  method: 'PUT',
  headers: {
    Authorization: 'Bearer petstore_auth',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    id: 0,
    category: {
      id: 0,
      name: 'string',
      sub: {
        prop1: 'string'
      }
    },
    name: 'Guru',
    photoUrls: [],
    friend: '[Circular Reference]',
    tags: [{
      id: 0,
      name: 'string'
    }],
    status: 'string',
    petType: 'string',
    huntingSkill: {
  
    }
  })
})

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://localhost/pet",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'id' => 0,
    'category' => [
        'id' => 0,
        'name' => 'string',
        'sub' => [
                'prop1' => 'string'
        ]
    ],
    'name' => 'Guru',
    'photoUrls' => [
        
    ],
    'friend' => '[Circular Reference]',
    'tags' => [
        [
                'id' => 0,
                'name' => 'string'
        ]
    ],
    'status' => 'string',
    'petType' => 'string',
    'huntingSkill' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer petstore_auth",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Python

import requests

url = "http://localhost/pet"

payload = {
    "id": 0,
    "category": {
        "id": 0,
        "name": "string",
        "sub": { "prop1": "string" }
    },
    "name": "Guru",
    "photoUrls": [],
    "friend": "[Circular Reference]",
    "tags": [
        {
            "id": 0,
            "name": "string"
        }
    ],
    "status": "string",
    "petType": "string",
    "huntingSkill": {}
}
headers = {
    "Authorization": "Bearer petstore_auth",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.json())

ID: deletePetBy"Id

OperationId with quotes

pet

DELETE

/pet

DELETE

/pet

Samples

cURLJavaScriptPHPPython

cURL

curl http://localhost/pet \
  --request DELETE \
  --header 'Content-Type: application/json'

JavaScript

fetch('http://localhost/pet', {
  method: 'DELETE',
  headers: {
    'Content-Type': 'application/json'
  }
})

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://localhost/pet",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Python

import requests

url = "http://localhost/pet"

headers = {"Content-Type": "application/json"}

response = requests.delete(url, headers=headers)

print(response.json())

ID: getPetById

Find pet by ID

pet

GET

/pet/{petId}

Returns a single pet

Authorizations

api_key

For this sample, you can use the api key special-key to test the authorization filters.

TypeAPI Key (header: api_key)

Parameters

Path Parameters

petId*

ID of pet to return

Typeinteger

Required

formatint64

Responses

successful operation

Content-Type

JSON

{

"id": 0,

"category": {

"id": 0,

"name": "string",

"sub": {

"prop1": "string"

}

"name": "Guru",

"photoUrls": [

"friend": "[Circular Reference]",

"tags": [

{

"id": 0,

"name": "string"

}

"status": "string",

"petType": "string",

"huntingSkill": {

}

GET

/pet/{petId}

Samples

cURLJavaScriptPHPPython

cURL

curl 'http://localhost/pet/%7BpetId%7D' \
  --header 'Api_key: api_key' \
  --header 'Content-Type: application/json'

JavaScript

fetch('http://localhost/pet/%7BpetId%7D', {
  headers: {
    Api_key: 'api_key',
    'Content-Type': 'application/json'
  }
})

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://localhost/pet/%7BpetId%7D",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Api_key: api_key",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Python

import requests

url = "http://localhost/pet/%7BpetId%7D"

headers = {
    "Api_key": "api_key",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)

print(response.json())

ID: updatePetWithForm

Updates a pet in the store with form data

pet

POST

/pet/{petId}

Authorizations

petstore_auth

Get access to data while protecting your account credentials.
OAuth2 is also a safer and more secure way to give you access.

implicit Flow

Authorization URLhttp://petstore.swagger.io/api/oauth/dialog

Scopes:

write:petsmodify pets in your account
read:petsread your pets

Parameters

Path Parameters

petId*

ID of pet that needs to be updated

Typeinteger

Required

formatint64

Request Body

JSON

{

"name": "string",

"status": "string"

}

Responses

Invalid input

POST

/pet/{petId}

Samples

cURLJavaScriptPHPPython

cURL

curl 'http://localhost/pet/%7BpetId%7D' \
  --request POST \
  --header 'Authorization: Bearer petstore_auth' \
  --header 'Content-Type: application/json'

JavaScript

fetch('http://localhost/pet/%7BpetId%7D', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer petstore_auth',
    'Content-Type': 'application/json'
  }
})

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://localhost/pet/%7BpetId%7D",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer petstore_auth",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Python

import requests

url = "http://localhost/pet/%7BpetId%7D"

headers = {
    "Authorization": "Bearer petstore_auth",
    "Content-Type": "application/json"
}

response = requests.post(url, headers=headers)

print(response.json())

ID: deletePet

Deletes a pet

pet

DELETE

/pet/{petId}

Authorizations

petstore_auth

Get access to data while protecting your account credentials.
OAuth2 is also a safer and more secure way to give you access.

implicit Flow

Authorization URLhttp://petstore.swagger.io/api/oauth/dialog

Scopes:

write:petsmodify pets in your account
read:petsread your pets

Parameters

Header Parameters

api_key

Typestring

ExampleBearer <TOKEN>

Path Parameters

petId*

Pet id to delete

Typeinteger

Required

formatint64

Responses

Invalid pet value

DELETE

/pet/{petId}

Samples

cURLJavaScriptPHPPython

cURL

curl 'http://localhost/pet/%7BpetId%7D' \
  --request DELETE \
  --header 'Api_key: Bearer <TOKEN>' \
  --header 'Authorization: Bearer petstore_auth' \
  --header 'Content-Type: application/json'

JavaScript

fetch('http://localhost/pet/%7BpetId%7D', {
  method: 'DELETE',
  headers: {
    Api_key: 'Bearer <TOKEN>',
    Authorization: 'Bearer petstore_auth',
    'Content-Type': 'application/json'
  }
})

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://localhost/pet/%7BpetId%7D",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Api_key: Bearer <TOKEN>",
    "Authorization: Bearer petstore_auth",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Python

import requests

url = "http://localhost/pet/%7BpetId%7D"

headers = {
    "Api_key": "Bearer <TOKEN>",
    "Authorization": "Bearer petstore_auth",
    "Content-Type": "application/json"
}

response = requests.delete(url, headers=headers)

print(response.json())

ID: uploadFile

uploads an image

pet

POST

/pet/{petId}/uploadImage

Authorizations

petstore_auth

Get access to data while protecting your account credentials.
OAuth2 is also a safer and more secure way to give you access.

implicit Flow

Authorization URLhttp://petstore.swagger.io/api/oauth/dialog

Scopes:

write:petsmodify pets in your account
read:petsread your pets

Parameters

Path Parameters

petId*

ID of pet to update

Typeinteger

Required

formatint64

Request Body

JSON

"string"

Responses

successful operation

Content-Type

application/json

JSON

{

"code": 0,

"type": "string",

"message": "string"

}

POST

/pet/{petId}/uploadImage

Samples

cURLJavaScriptPHPPython

cURL

curl 'http://localhost/pet/%7BpetId%7D/uploadImage' \
  --request POST \
  --header 'Authorization: Bearer petstore_auth' \
  --header 'Content-Type: application/json'

JavaScript

fetch('http://localhost/pet/%7BpetId%7D/uploadImage', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer petstore_auth',
    'Content-Type': 'application/json'
  }
})

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://localhost/pet/%7BpetId%7D/uploadImage",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer petstore_auth",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Python

import requests

url = "http://localhost/pet/%7BpetId%7D/uploadImage"

headers = {
    "Authorization": "Bearer petstore_auth",
    "Content-Type": "application/json"
}

response = requests.post(url, headers=headers)

print(response.json())

ID: findPetsByStatus

Finds Pets by status

pet

GET

/pet/findByStatus

Multiple status values can be provided with comma separated strings

Authorizations

petstore_auth

Get access to data while protecting your account credentials.
OAuth2 is also a safer and more secure way to give you access.

implicit Flow

Authorization URLhttp://petstore.swagger.io/api/oauth/dialog

Scopes:

write:petsmodify pets in your account
read:petsread your pets

Parameters

Query Parameters

status*

Status values that need to be considered for filter

Typearray

Required

minItems1

maxItems3

Responses

successful operation

Content-Type

JSON

[

{

"id": 0,

"category": {

"id": 0,

"name": "string",

"sub": {

"prop1": "string"

}

"name": "Guru",

"photoUrls": [

"friend": "[Circular Reference]",

"tags": [

{

"id": 0,

"name": "string"

}

"status": "string",

"petType": "string",

"huntingSkill": {

}

]

GET

/pet/findByStatus

Samples

cURLJavaScriptPHPPython

cURL

curl http://localhost/pet/findByStatus \
  --header 'Authorization: Bearer petstore_auth' \
  --header 'Content-Type: application/json'

JavaScript

fetch('http://localhost/pet/findByStatus', {
  headers: {
    Authorization: 'Bearer petstore_auth',
    'Content-Type': 'application/json'
  }
})

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://localhost/pet/findByStatus",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer petstore_auth",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Python

import requests

url = "http://localhost/pet/findByStatus"

headers = {
    "Authorization": "Bearer petstore_auth",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)

print(response.json())

Deprecated

ID: findPetsByTags

Finds Pets by tags

pet

GET

/pet/findByTags

Multiple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.

Authorizations

petstore_auth

Get access to data while protecting your account credentials.
OAuth2 is also a safer and more secure way to give you access.

implicit Flow

Authorization URLhttp://petstore.swagger.io/api/oauth/dialog

Scopes:

write:petsmodify pets in your account
read:petsread your pets

Parameters

Query Parameters

tags*

Tags to filter by

Typearray

Required

Responses

successful operation

Content-Type

JSON

[

{

"id": 0,

"category": {

"id": 0,

"name": "string",

"sub": {

"prop1": "string"

}

"name": "Guru",

"photoUrls": [

"friend": "[Circular Reference]",

"tags": [

{

"id": 0,

"name": "string"

}

"status": "string",

"petType": "string",

"huntingSkill": {

}

]

GET

/pet/findByTags

Samples

cURLJavaScriptPHPPython

cURL

curl http://localhost/pet/findByTags \
  --header 'Authorization: Bearer petstore_auth' \
  --header 'Content-Type: application/json'

JavaScript

fetch('http://localhost/pet/findByTags', {
  headers: {
    Authorization: 'Bearer petstore_auth',
    'Content-Type': 'application/json'
  }
})

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://localhost/pet/findByTags",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer petstore_auth",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Python

import requests

url = "http://localhost/pet/findByTags"

headers = {
    "Authorization": "Bearer petstore_auth",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)

print(response.json())

store

Access to Petstore orders

Operations

GET/store/inventory POST/store/order GET/store/order/{orderId}DELETE/store/order/{orderId}POST/store/subscribe

ID: getInventory

Returns pet inventories by status

store

GET

/store/inventory

Returns a map of status codes to quantities

Authorizations

api_key

For this sample, you can use the api key special-key to test the authorization filters.

TypeAPI Key (header: api_key)

Responses

successful operation

Content-Type

application/json

JSON

{

"additionalProperties": 0

}

GET

/store/inventory

Samples

cURLJavaScriptPHPPython

cURL

curl http://localhost/store/inventory \
  --header 'Api_key: api_key' \
  --header 'Content-Type: application/json'

JavaScript

fetch('http://localhost/store/inventory', {
  headers: {
    Api_key: 'api_key',
    'Content-Type': 'application/json'
  }
})

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://localhost/store/inventory",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Api_key: api_key",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Python

import requests

url = "http://localhost/store/inventory"

headers = {
    "Api_key": "api_key",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)

print(response.json())

ID: placeOrder

Place an order for a pet

store

POST

/store/order

Request Body

JSON

{

"id": 0,

"petId": 0,

"quantity": 1,

"shipDate": "string",

"status": "string",

"complete": false,

"requestId": "string"

}

Responses

successful operation

Content-Type

JSON

{

"id": 0,

"petId": 0,

"quantity": 1,

"shipDate": "string",

"status": "string",

"complete": false,

"requestId": "string"

}

POST

/store/order

Samples

cURLJavaScriptPHPPython

cURL

curl http://localhost/store/order \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 0,
  "petId": 0,
  "quantity": 1,
  "shipDate": "string",
  "status": "string",
  "complete": false,
  "requestId": "string"
}'

JavaScript

fetch('http://localhost/store/order', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    id: 0,
    petId: 0,
    quantity: 1,
    shipDate: 'string',
    status: 'string',
    complete: false,
    requestId: 'string'
  })
})

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://localhost/store/order",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'id' => 0,
    'petId' => 0,
    'quantity' => 1,
    'shipDate' => 'string',
    'status' => 'string',
    'complete' => null,
    'requestId' => 'string'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Python

import requests

url = "http://localhost/store/order"

payload = {
    "id": 0,
    "petId": 0,
    "quantity": 1,
    "shipDate": "string",
    "status": "string",
    "complete": False,
    "requestId": "string"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

ID: getOrderById

Find purchase order by ID

store

GET

/store/order/{orderId}

For valid response try integer IDs with value <= 5 or > 10. Other values will generated exceptions

Parameters

Path Parameters

orderId*

ID of pet that needs to be fetched

Typeinteger

Required

formatint64

minimum1

maximum5

Responses

successful operation

Content-Type

JSON

{

"id": 0,

"petId": 0,

"quantity": 1,

"shipDate": "string",

"status": "string",

"complete": false,

"requestId": "string"

}

GET

/store/order/{orderId}

Samples

cURLJavaScriptPHPPython

cURL

curl 'http://localhost/store/order/%7BorderId%7D' \
  --header 'Content-Type: application/json'

JavaScript

fetch('http://localhost/store/order/%7BorderId%7D', {
  headers: {
    'Content-Type': 'application/json'
  }
})

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://localhost/store/order/%7BorderId%7D",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Python

import requests

url = "http://localhost/store/order/%7BorderId%7D"

headers = {"Content-Type": "application/json"}

response = requests.get(url, headers=headers)

print(response.json())

ID: deleteOrder

Delete purchase order by ID

store

DELETE

/store/order/{orderId}

For valid response try integer IDs with value < 1000. Anything above 1000 or nonintegers will generate API errors

Parameters

Path Parameters

orderId*

ID of the order that needs to be deleted

Typestring

Required

minimum1

Responses

Invalid ID supplied

DELETE

/store/order/{orderId}

Samples

cURLJavaScriptPHPPython

cURL

curl 'http://localhost/store/order/%7BorderId%7D' \
  --request DELETE \
  --header 'Content-Type: application/json'

JavaScript

fetch('http://localhost/store/order/%7BorderId%7D', {
  method: 'DELETE',
  headers: {
    'Content-Type': 'application/json'
  }
})

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://localhost/store/order/%7BorderId%7D",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Python

import requests

url = "http://localhost/store/order/%7BorderId%7D"

headers = {"Content-Type": "application/json"}

response = requests.delete(url, headers=headers)

print(response.json())

ID: post-store-subscribe

store

POST

/store/subscribe

Add subscription for a store events

JSON

{

"callbackUrl": "https://myserver.com/send/callback/here",

"eventName": "string"

}

Successful operation

Content-Type

application/json

JSON

[

]

POST

/store/subscribe

cURLJavaScriptPHPPython

cURL

curl http://localhost/store/subscribe \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "callbackUrl": "https://myserver.com/send/callback/here",
  "eventName": "string"
}'

JavaScript

fetch('http://localhost/store/subscribe', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    callbackUrl: 'https://myserver.com/send/callback/here',
    eventName: 'string'
  })
})

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://localhost/store/subscribe",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'callbackUrl' => 'https://myserver.com/send/callback/here',
    'eventName' => 'string'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Python

import requests

url = "http://localhost/store/subscribe"

payload = {
    "callbackUrl": "https://myserver.com/send/callback/here",
    "eventName": "string"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

user

Operations about user

Operations

POST/user GET/user/{username}PUT/user/{username}DELETE/user/{username}POST/user/createWithArray POST/user/createWithList GET/user/login GET/user/logout

ID: createUser

Create user

user

POST

/user

This can only be done by the logged in user.

Request Body

JSON

{

"id": 0,

"pet": {

"id": 0,

"category": {

"id": 0,

"name": "string",

"sub": {

"prop1": "string"

}

"name": "Guru",

"photoUrls": [

"friend": "[Circular Reference]",

"tags": [

{

"id": 0,

"name": "string"

}

"status": "string",

"petType": "string",

"huntingSkill": {

}

"username": "John78",

"firstName": "John",

"lastName": "Smith",

"email": "john.smith@example.com",

"password": "drowssaP123",

"phone": "+1-202-555-0192",

"userStatus": 0,

"image": "string",

"addresses": [

"string"

]

}

Responses

successful operation

POST

/user

Samples

cURLJavaScriptPHPPython

cURL

curl http://localhost/user \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 0,
  "pet": {
    "id": 0,
    "category": {
      "id": 0,
      "name": "string",
      "sub": {
        "prop1": "string"
      }
    },
    "name": "Guru",
    "photoUrls": [],
    "friend": "[Circular Reference]",
    "tags": [
      {
        "id": 0,
        "name": "string"
      }
    ],
    "status": "string",
    "petType": "string",
    "huntingSkill": {}
  },
  "username": "John78",
  "firstName": "John",
  "lastName": "Smith",
  "email": "john.smith@example.com",
  "password": "drowssaP123",
  "phone": "+1-202-555-0192",
  "userStatus": 0,
  "image": "string",
  "addresses": [
    "string"
  ]
}'

JavaScript

fetch('http://localhost/user', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    id: 0,
    pet: {
      id: 0,
      category: {
        id: 0,
        name: 'string',
        sub: {
          prop1: 'string'
        }
      },
      name: 'Guru',
      photoUrls: [],
      friend: '[Circular Reference]',
      tags: [{
        id: 0,
        name: 'string'
      }],
      status: 'string',
      petType: 'string',
      huntingSkill: {
  
      }
    },
    username: 'John78',
    firstName: 'John',
    lastName: 'Smith',
    email: 'john.smith@example.com',
    password: 'drowssaP123',
    phone: '+1-202-555-0192',
    userStatus: 0,
    image: 'string',
    addresses: ['string']
  })
})

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://localhost/user",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'id' => 0,
    'pet' => [
        'id' => 0,
        'category' => [
                'id' => 0,
                'name' => 'string',
                'sub' => [
                                'prop1' => 'string'
                ]
        ],
        'name' => 'Guru',
        'photoUrls' => [
                
        ],
        'friend' => '[Circular Reference]',
        'tags' => [
                [
                                'id' => 0,
                                'name' => 'string'
                ]
        ],
        'status' => 'string',
        'petType' => 'string',
        'huntingSkill' => [
                
        ]
    ],
    'username' => 'John78',
    'firstName' => 'John',
    'lastName' => 'Smith',
    'email' => 'john.smith@example.com',
    'password' => 'drowssaP123',
    'phone' => '+1-202-555-0192',
    'userStatus' => 0,
    'image' => 'string',
    'addresses' => [
        'string'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Python

import requests

url = "http://localhost/user"

payload = {
    "id": 0,
    "pet": {
        "id": 0,
        "category": {
            "id": 0,
            "name": "string",
            "sub": { "prop1": "string" }
        },
        "name": "Guru",
        "photoUrls": [],
        "friend": "[Circular Reference]",
        "tags": [
            {
                "id": 0,
                "name": "string"
            }
        ],
        "status": "string",
        "petType": "string",
        "huntingSkill": {}
    },
    "username": "John78",
    "firstName": "John",
    "lastName": "Smith",
    "email": "john.smith@example.com",
    "password": "drowssaP123",
    "phone": "+1-202-555-0192",
    "userStatus": 0,
    "image": "string",
    "addresses": ["string"]
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

ID: getUserByName

Get user by user name

user

GET

/user/{username}

Parameters

Path Parameters

username*

The name that needs to be fetched. Use user1 for testing.

Typestring

Required

Responses

successful operation

Content-Type

JSON

{

"id": 0,

"pet": {

"id": 0,

"category": {

"id": 0,

"name": "string",

"sub": {

"prop1": "string"

}

"name": "Guru",

"photoUrls": [

"friend": "[Circular Reference]",

"tags": [

{

"id": 0,

"name": "string"

}

"status": "string",

"petType": "string",

"huntingSkill": {

}

"username": "John78",

"firstName": "John",

"lastName": "Smith",

"email": "john.smith@example.com",

"password": "drowssaP123",

"phone": "+1-202-555-0192",

"userStatus": 0,

"image": "string",

"addresses": [

"string"

]

}

GET

/user/{username}

Samples

cURLJavaScriptPHPPython

cURL

curl 'http://localhost/user/%7Busername%7D' \
  --header 'Content-Type: application/json'

JavaScript

fetch('http://localhost/user/%7Busername%7D', {
  headers: {
    'Content-Type': 'application/json'
  }
})

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://localhost/user/%7Busername%7D",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Python

import requests

url = "http://localhost/user/%7Busername%7D"

headers = {"Content-Type": "application/json"}

response = requests.get(url, headers=headers)

print(response.json())

ID: updateUser

Updated user

user

PUT

/user/{username}

This can only be done by the logged in user.

Parameters

Path Parameters

username*

name that need to be updated

Typestring

Required

Request Body

JSON

{

"id": 0,

"pet": {

"id": 0,

"category": {

"id": 0,

"name": "string",

"sub": {

"prop1": "string"

}

"name": "Guru",

"photoUrls": [

"friend": "[Circular Reference]",

"tags": [

{

"id": 0,

"name": "string"

}

"status": "string",

"petType": "string",

"huntingSkill": {

}

"username": "John78",

"firstName": "John",

"lastName": "Smith",

"email": "john.smith@example.com",

"password": "drowssaP123",

"phone": "+1-202-555-0192",

"userStatus": 0,

"image": "string",

"addresses": [

"string"

]

}

Responses

User is updated successfully

Content-Type

application/json

JSON

{

"id": 0,

"pet": {

"id": 0,

"category": {

"id": 0,

"name": "string",

"sub": {

"prop1": "string"

}

"name": "Guru",

"photoUrls": [

"friend": "[Circular Reference]",

"tags": [

{

"id": 0,

"name": "string"

}

"status": "string",

"petType": "string",

"huntingSkill": {

}

"username": "John78",

"firstName": "John",

"lastName": "Smith",

"email": "john.smith@example.com",

"password": "drowssaP123",

"phone": "+1-202-555-0192",

"userStatus": 0,

"image": "string",

"addresses": [

"string"

]

}

PUT

/user/{username}

Samples

cURLJavaScriptPHPPython

cURL

curl 'http://localhost/user/%7Busername%7D' \
  --request PUT \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 0,
  "pet": {
    "id": 0,
    "category": {
      "id": 0,
      "name": "string",
      "sub": {
        "prop1": "string"
      }
    },
    "name": "Guru",
    "photoUrls": [],
    "friend": "[Circular Reference]",
    "tags": [
      {
        "id": 0,
        "name": "string"
      }
    ],
    "status": "string",
    "petType": "string",
    "huntingSkill": {}
  },
  "username": "John78",
  "firstName": "John",
  "lastName": "Smith",
  "email": "john.smith@example.com",
  "password": "drowssaP123",
  "phone": "+1-202-555-0192",
  "userStatus": 0,
  "image": "string",
  "addresses": [
    "string"
  ]
}'

JavaScript

fetch('http://localhost/user/%7Busername%7D', {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    id: 0,
    pet: {
      id: 0,
      category: {
        id: 0,
        name: 'string',
        sub: {
          prop1: 'string'
        }
      },
      name: 'Guru',
      photoUrls: [],
      friend: '[Circular Reference]',
      tags: [{
        id: 0,
        name: 'string'
      }],
      status: 'string',
      petType: 'string',
      huntingSkill: {
  
      }
    },
    username: 'John78',
    firstName: 'John',
    lastName: 'Smith',
    email: 'john.smith@example.com',
    password: 'drowssaP123',
    phone: '+1-202-555-0192',
    userStatus: 0,
    image: 'string',
    addresses: ['string']
  })
})

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://localhost/user/%7Busername%7D",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'id' => 0,
    'pet' => [
        'id' => 0,
        'category' => [
                'id' => 0,
                'name' => 'string',
                'sub' => [
                                'prop1' => 'string'
                ]
        ],
        'name' => 'Guru',
        'photoUrls' => [
                
        ],
        'friend' => '[Circular Reference]',
        'tags' => [
                [
                                'id' => 0,
                                'name' => 'string'
                ]
        ],
        'status' => 'string',
        'petType' => 'string',
        'huntingSkill' => [
                
        ]
    ],
    'username' => 'John78',
    'firstName' => 'John',
    'lastName' => 'Smith',
    'email' => 'john.smith@example.com',
    'password' => 'drowssaP123',
    'phone' => '+1-202-555-0192',
    'userStatus' => 0,
    'image' => 'string',
    'addresses' => [
        'string'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Python

import requests

url = "http://localhost/user/%7Busername%7D"

payload = {
    "id": 0,
    "pet": {
        "id": 0,
        "category": {
            "id": 0,
            "name": "string",
            "sub": { "prop1": "string" }
        },
        "name": "Guru",
        "photoUrls": [],
        "friend": "[Circular Reference]",
        "tags": [
            {
                "id": 0,
                "name": "string"
            }
        ],
        "status": "string",
        "petType": "string",
        "huntingSkill": {}
    },
    "username": "John78",
    "firstName": "John",
    "lastName": "Smith",
    "email": "john.smith@example.com",
    "password": "drowssaP123",
    "phone": "+1-202-555-0192",
    "userStatus": 0,
    "image": "string",
    "addresses": ["string"]
}
headers = {"Content-Type": "application/json"}

response = requests.put(url, json=payload, headers=headers)

print(response.json())

ID: deleteUser

Delete user

user

DELETE

/user/{username}

This can only be done by the logged in user.

Parameters

Path Parameters

username*

The name that needs to be deleted

Typestring

Required

Responses

User is deleted

DELETE

/user/{username}

Samples

cURLJavaScriptPHPPython

cURL

curl 'http://localhost/user/%7Busername%7D' \
  --request DELETE \
  --header 'Content-Type: application/json'

JavaScript

fetch('http://localhost/user/%7Busername%7D', {
  method: 'DELETE',
  headers: {
    'Content-Type': 'application/json'
  }
})

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://localhost/user/%7Busername%7D",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Python

import requests

url = "http://localhost/user/%7Busername%7D"

headers = {"Content-Type": "application/json"}

response = requests.delete(url, headers=headers)

print(response.json())

ID: createUsersWithArrayInput

Creates list of users with given input array

user

POST

/user/createWithArray

Request Body

JSON

[

{

"id": 0,

"pet": {

"id": 0,

"category": {

"id": 0,

"name": "string",

"sub": {

"prop1": "string"

}

"name": "Guru",

"photoUrls": [

"friend": "[Circular Reference]",

"tags": [

{

"id": 0,

"name": "string"

}

"status": "string",

"petType": "string",

"huntingSkill": {

}

"username": "John78",

"firstName": "John",

"lastName": "Smith",

"email": "john.smith@example.com",

"password": "drowssaP123",

"phone": "+1-202-555-0192",

"userStatus": 0,

"image": "string",

"addresses": [

"string"

]

}

]

Responses

successful operation

POST

/user/createWithArray

Samples

cURLJavaScriptPHPPython

cURL

curl http://localhost/user/createWithArray \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '[
  {
    "id": 0,
    "pet": {
      "id": 0,
      "category": {
        "id": 0,
        "name": "string",
        "sub": {
          "prop1": "string"
        }
      },
      "name": "Guru",
      "photoUrls": [],
      "friend": "[Circular Reference]",
      "tags": [
        {
          "id": 0,
          "name": "string"
        }
      ],
      "status": "string",
      "petType": "string",
      "huntingSkill": {}
    },
    "username": "John78",
    "firstName": "John",
    "lastName": "Smith",
    "email": "john.smith@example.com",
    "password": "drowssaP123",
    "phone": "+1-202-555-0192",
    "userStatus": 0,
    "image": "string",
    "addresses": [
      "string"
    ]
  }
]'

JavaScript

fetch('http://localhost/user/createWithArray', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    0: {
      id: 0,
      pet: {
        id: 0,
        category: {
          id: 0,
          name: 'string',
          sub: {
            prop1: 'string'
          }
        },
        name: 'Guru',
        photoUrls: [],
        friend: '[Circular Reference]',
        tags: [{
          id: 0,
          name: 'string'
        }],
        status: 'string',
        petType: 'string',
        huntingSkill: {
  
        }
      },
      username: 'John78',
      firstName: 'John',
      lastName: 'Smith',
      email: 'john.smith@example.com',
      password: 'drowssaP123',
      phone: '+1-202-555-0192',
      userStatus: 0,
      image: 'string',
      addresses: ['string']
    }
  })
})

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://localhost/user/createWithArray",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    [
        'id' => 0,
        'pet' => [
                'id' => 0,
                'category' => [
                                'id' => 0,
                                'name' => 'string',
                                'sub' => [
                                                                'prop1' => 'string'
                                ]
                ],
                'name' => 'Guru',
                'photoUrls' => [
                                
                ],
                'friend' => '[Circular Reference]',
                'tags' => [
                                [
                                                                'id' => 0,
                                                                'name' => 'string'
                                ]
                ],
                'status' => 'string',
                'petType' => 'string',
                'huntingSkill' => [
                                
                ]
        ],
        'username' => 'John78',
        'firstName' => 'John',
        'lastName' => 'Smith',
        'email' => 'john.smith@example.com',
        'password' => 'drowssaP123',
        'phone' => '+1-202-555-0192',
        'userStatus' => 0,
        'image' => 'string',
        'addresses' => [
                'string'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Python

import requests

url = "http://localhost/user/createWithArray"

payload = [
    {
        "id": 0,
        "pet": {
            "id": 0,
            "category": {
                "id": 0,
                "name": "string",
                "sub": { "prop1": "string" }
            },
            "name": "Guru",
            "photoUrls": [],
            "friend": "[Circular Reference]",
            "tags": [
                {
                    "id": 0,
                    "name": "string"
                }
            ],
            "status": "string",
            "petType": "string",
            "huntingSkill": {}
        },
        "username": "John78",
        "firstName": "John",
        "lastName": "Smith",
        "email": "john.smith@example.com",
        "password": "drowssaP123",
        "phone": "+1-202-555-0192",
        "userStatus": 0,
        "image": "string",
        "addresses": ["string"]
    }
]
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

ID: createUsersWithListInput

Creates list of users with given input array

user

POST

/user/createWithList

Request Body

JSON

[

{

"id": 0,

"pet": {

"id": 0,

"category": {

"id": 0,

"name": "string",

"sub": {

"prop1": "string"

}

"name": "Guru",

"photoUrls": [

"friend": "[Circular Reference]",

"tags": [

{

"id": 0,

"name": "string"

}

"status": "string",

"petType": "string",

"huntingSkill": {

}

"username": "John78",

"firstName": "John",

"lastName": "Smith",

"email": "john.smith@example.com",

"password": "drowssaP123",

"phone": "+1-202-555-0192",

"userStatus": 0,

"image": "string",

"addresses": [

"string"

]

}

]

Responses

successful operation

POST

/user/createWithList

Samples

cURLJavaScriptPHPPython

cURL

curl http://localhost/user/createWithList \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '[
  {
    "id": 0,
    "pet": {
      "id": 0,
      "category": {
        "id": 0,
        "name": "string",
        "sub": {
          "prop1": "string"
        }
      },
      "name": "Guru",
      "photoUrls": [],
      "friend": "[Circular Reference]",
      "tags": [
        {
          "id": 0,
          "name": "string"
        }
      ],
      "status": "string",
      "petType": "string",
      "huntingSkill": {}
    },
    "username": "John78",
    "firstName": "John",
    "lastName": "Smith",
    "email": "john.smith@example.com",
    "password": "drowssaP123",
    "phone": "+1-202-555-0192",
    "userStatus": 0,
    "image": "string",
    "addresses": [
      "string"
    ]
  }
]'

JavaScript

fetch('http://localhost/user/createWithList', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    0: {
      id: 0,
      pet: {
        id: 0,
        category: {
          id: 0,
          name: 'string',
          sub: {
            prop1: 'string'
          }
        },
        name: 'Guru',
        photoUrls: [],
        friend: '[Circular Reference]',
        tags: [{
          id: 0,
          name: 'string'
        }],
        status: 'string',
        petType: 'string',
        huntingSkill: {
  
        }
      },
      username: 'John78',
      firstName: 'John',
      lastName: 'Smith',
      email: 'john.smith@example.com',
      password: 'drowssaP123',
      phone: '+1-202-555-0192',
      userStatus: 0,
      image: 'string',
      addresses: ['string']
    }
  })
})

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://localhost/user/createWithList",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    [
        'id' => 0,
        'pet' => [
                'id' => 0,
                'category' => [
                                'id' => 0,
                                'name' => 'string',
                                'sub' => [
                                                                'prop1' => 'string'
                                ]
                ],
                'name' => 'Guru',
                'photoUrls' => [
                                
                ],
                'friend' => '[Circular Reference]',
                'tags' => [
                                [
                                                                'id' => 0,
                                                                'name' => 'string'
                                ]
                ],
                'status' => 'string',
                'petType' => 'string',
                'huntingSkill' => [
                                
                ]
        ],
        'username' => 'John78',
        'firstName' => 'John',
        'lastName' => 'Smith',
        'email' => 'john.smith@example.com',
        'password' => 'drowssaP123',
        'phone' => '+1-202-555-0192',
        'userStatus' => 0,
        'image' => 'string',
        'addresses' => [
                'string'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Python

import requests

url = "http://localhost/user/createWithList"

payload = [
    {
        "id": 0,
        "pet": {
            "id": 0,
            "category": {
                "id": 0,
                "name": "string",
                "sub": { "prop1": "string" }
            },
            "name": "Guru",
            "photoUrls": [],
            "friend": "[Circular Reference]",
            "tags": [
                {
                    "id": 0,
                    "name": "string"
                }
            ],
            "status": "string",
            "petType": "string",
            "huntingSkill": {}
        },
        "username": "John78",
        "firstName": "John",
        "lastName": "Smith",
        "email": "john.smith@example.com",
        "password": "drowssaP123",
        "phone": "+1-202-555-0192",
        "userStatus": 0,
        "image": "string",
        "addresses": ["string"]
    }
]
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

ID: loginUser

Logs user into the system

user

GET

/user/login

Parameters

Query Parameters

username*

The user name for login

Typestring

Required

password*

The password for login in clear text

Typestring

Required

Responses

successful operation

Content-Type

JSON

"OK"

GET

/user/login

Samples

cURLJavaScriptPHPPython

cURL

curl http://localhost/user/login \
  --header 'Content-Type: application/json'

JavaScript

fetch('http://localhost/user/login', {
  headers: {
    'Content-Type': 'application/json'
  }
})

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://localhost/user/login",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Python

import requests

url = "http://localhost/user/login"

headers = {"Content-Type": "application/json"}

response = requests.get(url, headers=headers)

print(response.json())

ID: logoutUser

Logs out current logged in user session

user

GET

/user/logout

Responses

successful operation

GET

/user/logout

Samples

cURLJavaScriptPHPPython

cURL

curl http://localhost/user/logout \
  --header 'Content-Type: application/json'

JavaScript

fetch('http://localhost/user/logout', {
  headers: {
    'Content-Type': 'application/json'
  }
})

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://localhost/user/logout",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Python

import requests

url = "http://localhost/user/logout"

headers = {"Content-Type": "application/json"}

response = requests.get(url, headers=headers)

print(response.json())

Swagger Petstore​

Introduction

OpenAPI Specification

Cross-Origin Resource Sharing

Authentication

Contact​

Terms of Service​

License​

External Documentation​

Servers​

pet​

Operations​

OperationId with backslash​

Samples​

Add a new pet to the store​

Authorizations​

Request Body​

Responses​

Samples​

Update an existing pet​

Authorizations​

Request Body​

Responses​

Samples​

OperationId with quotes​

Samples​

Find pet by ID​

Authorizations​

Parameters​

Path Parameters

Responses​

Samples​

Updates a pet in the store with form data​

Authorizations​

Parameters​

Path Parameters

Request Body​

Responses​

Samples​

Deletes a pet​

Authorizations​

Parameters​

Header Parameters

Path Parameters

Responses​

Samples​

uploads an image​

Authorizations​

Parameters​

Path Parameters

Request Body​

Responses​

Samples​

Finds Pets by status​

Authorizations​

Parameters​

Query Parameters

Responses​

Samples​

Finds Pets by tags​

Authorizations​

Parameters​

Query Parameters

Responses​

Samples​

store​

Operations​

Returns pet inventories by status​

Authorizations​

Responses​

Samples​

Place an order for a pet​

Request Body​

Responses​

Samples​

Find purchase order by ID​

Parameters​

Path Parameters

Responses​

Samples​

Swagger Petstore

Contact

Terms of Service

License

External Documentation

Servers

pet

Operations

OperationId with backslash

Samples

Add a new pet to the store

Authorizations

Request Body

Responses

Samples

Update an existing pet

Authorizations

Request Body

Responses

Samples

OperationId with quotes

Samples

Find pet by ID

Authorizations

Parameters

Responses

Samples

Updates a pet in the store with form data

Authorizations

Parameters

Request Body

Responses

Samples

Deletes a pet

Authorizations

Parameters

Responses

Samples

uploads an image

Authorizations

Parameters

Request Body

Responses

Samples

Finds Pets by status

Authorizations

Parameters

Responses

Samples

Finds Pets by tags

Authorizations

Parameters

Responses

Samples

store

Operations

Returns pet inventories by status

Authorizations

Responses

Samples

Place an order for a pet

Request Body

Responses

Samples

Find purchase order by ID

Parameters

Responses

Samples

Delete purchase order by ID

Parameters

Responses

Samples

Subscribe to the Store events

Request Body

Responses

Samples

user

Operations

Create user

Request Body