shins

<!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <meta content="IE=edge,chrome=1" http-equiv="X-UA-Compatible"> <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1"> <title>Swagger Petstore v1.0.0</title> <style> </style> <link rel="stylesheet" media="screen" href="pub/css/screen.css"> <link rel="stylesheet" media="print" href="pub/css/print.css"> <link rel="stylesheet" media="screen" href="pub/css/darkula.css"> <script src="source/javascripts/lib/_jquery.js"></script> <script src="source/javascripts/lib/_jquery.highlight.js"></script> <script src="source/javascripts/lib/_lunr.js"></script> <script src="source/javascripts/lib/_imagesloaded.min.js"></script> <script src="source/javascripts/lib/_energize.js"></script> <script src="source/javascripts/app/_lang.js"></script> <script src="source/javascripts/app/_search.js"></script> <script src="source/javascripts/app/_toc.js"></script> <script type="text/javascript"> $(function() { loadToc($('#toc'), '.toc-link', '.toc-list-h2, .toc-list-h3, .toc-list-h4, .toc-list-h5, .toc-list-h6', 10); setupLanguages($('body').data('languages')); $('.content').imagesLoaded( function() { recacheHeights(); refreshToc(); }); }); window.onpopstate = function() { activateLanguage(getLanguageFromQueryString()); }; </script>  <meta name="theme-color" content="#F3F7F9">         </head> <body data-languages="["shell","http","javascript","ruby","python","php","java","go"]"> <a href="#" id="nav-button"> NAV <img src="source/images/navbar.png" class="undefined" alt="Navigation"> </a> <div class="toc-wrapper"> <img src="source/images/logo.png" class="logo" alt="Logo"> <div class="lang-selector"> <a href="#" data-language-name="shell">Shell</a> <a href="#" data-language-name="http">HTTP</a> <a href="#" data-language-name="javascript">JavaScript</a> <a href="#" data-language-name="ruby">Ruby</a> <a href="#" data-language-name="python">Python</a> <a href="#" data-language-name="php">PHP</a> <a href="#" data-language-name="java">Java</a> <a href="#" data-language-name="go">Go</a> </div> <div class="search"> <input type="text" class="search" id="input-search" placeholder="Search"> </div> <ul class="search-results"></ul> <div id="toc" class="toc-list-h1"> <ul class="toc-list-h1"> <li> <a href="#swagger-petstore" class="toc-h1 toc-link" data-title="Swagger Petstore v1.0.0">Swagger Petstore v1.0.0</a> </li> <li> <a href="#authentication" class="toc-h1 toc-link" data-title="Authentication">Authentication</a> </li> <li> <a href="#swagger-petstore-pet" class="toc-h1 toc-link" data-title="pet">pet</a> <ul class="toc-list-h2"> <li> <a href="#addpet" class="toc-h2 toc-link" data-title="">addPet</a> </li> <li> <a href="#updatepet" class="toc-h2 toc-link" data-title="">updatePet</a> </li> <li> <a href="#findpetsbystatus" class="toc-h2 toc-link" data-title="">findPetsByStatus</a> </li> <li> <a href="#findpetsbytags" class="toc-h2 toc-link" data-title="">findPetsByTags</a> </li> <li> <a href="#getpetbyid" class="toc-h2 toc-link" data-title="">getPetById</a> </li> <li> <a href="#updatepetwithform" class="toc-h2 toc-link" data-title="">updatePetWithForm</a> </li> <li> <a href="#deletepet" class="toc-h2 toc-link" data-title="">deletePet</a> </li> <li> <a href="#uploadfile" class="toc-h2 toc-link" data-title="">uploadFile</a> </li> </ul> </li> <li> <a href="#swagger-petstore-store" class="toc-h1 toc-link" data-title="store">store</a> <ul class="toc-list-h2"> <li> <a href="#getinventory" class="toc-h2 toc-link" data-title="">getInventory</a> </li> <li> <a href="#placeorder" class="toc-h2 toc-link" data-title="">placeOrder</a> </li> <li> <a href="#getorderbyid" class="toc-h2 toc-link" data-title="">getOrderById</a> </li> <li> <a href="#deleteorder" class="toc-h2 toc-link" data-title="">deleteOrder</a> </li> </ul> </li> <li> <a href="#swagger-petstore-user" class="toc-h1 toc-link" data-title="user">user</a> <ul class="toc-list-h2"> <li> <a href="#createuser" class="toc-h2 toc-link" data-title="">createUser</a> </li> <li> <a href="#createuserswitharrayinput" class="toc-h2 toc-link" data-title="">createUsersWithArrayInput</a> </li> <li> <a href="#createuserswithlistinput" class="toc-h2 toc-link" data-title="">createUsersWithListInput</a> </li> <li> <a href="#loginuser" class="toc-h2 toc-link" data-title="">loginUser</a> </li> <li> <a href="#logoutuser" class="toc-h2 toc-link" data-title="">logoutUser</a> </li> <li> <a href="#getuserbyname" class="toc-h2 toc-link" data-title="">getUserByName</a> </li> <li> <a href="#updateuser" class="toc-h2 toc-link" data-title="">updateUser</a> </li> <li> <a href="#deleteuser" class="toc-h2 toc-link" data-title="">deleteUser</a> </li> </ul> </li> <li> <a href="#schemas" class="toc-h1 toc-link" data-title="Schemas">Schemas</a> <ul class="toc-list-h2"> <li> <a href="#tocs_order" class="toc-h2 toc-link" data-title="">Order</a> </li> <li> <a href="#tocs_category" class="toc-h2 toc-link" data-title="">Category</a> </li> <li> <a href="#tocs_user" class="toc-h2 toc-link" data-title="">User</a> </li> <li> <a href="#tocs_tag" class="toc-h2 toc-link" data-title="">Tag</a> </li> <li> <a href="#tocs_pet" class="toc-h2 toc-link" data-title="">Pet</a> </li> <li> <a href="#tocs_apiresponse" class="toc-h2 toc-link" data-title="">ApiResponse</a> </li> </ul> </li> </ul> </div> <ul class="toc-footer"> <li><a href="https://mermade.github.io/shins/asyncapi.html">See AsyncAPI example</a></li> </ul> </div> <div class="page-wrapper"> <div class="dark-box"></div> <div class="content">  <h1 id="swagger-petstore">Swagger Petstore v1.0.0</h1> <blockquote> Scroll down for code samples, example requests and responses. Select a language for code samples from the tabs above or the mobile navigation menu. </blockquote> 🐶 🐱 🐰 This is a sample server Petstore server. You can find out more about Swagger at <a href="http://swagger.io">http://swagger.io</a> or on <a href="http://swagger.io/irc/">irc.freenode.net, #swagger</a>. For this sample, you can use the api key <code>special-key</code> to test the authorization filters. Base URLs: <ul> <li><a href="http://petstore.swagger.io/v2">http://petstore.swagger.io/v2</a></li> </ul> <a href="http://swagger.io/terms/">Terms of service</a> Email: <a href="mailto:apiteam@swagger.io">Support</a> License: <a href="http://www.apache.org/licenses/LICENSE-2.0.html">Apache 2.0</a> <h1 id="authentication">Authentication</h1> <ul> <li> oAuth2 authentication. <ul> <li>Flow: implicit</li> <li>Authorization URL = <a href="http://petstore.swagger.io/oauth/dialog">http://petstore.swagger.io/oauth/dialog</a></li> </ul> </li> </ul> <table> <thead> <tr> <th>Scope</th> <th>Scope Description</th> </tr> </thead> <tbody> <tr> <td>write:pets</td> <td>modify pets in your account</td> </tr> <tr> <td>read:pets</td> <td>read your pets</td> </tr> </tbody> </table> <ul> <li>API Key (api_key) <ul> <li>Parameter Name: api_key, in: header.</li> </ul> </li> </ul> <h1 id="swagger-petstore-pet">pet</h1> Everything about your Pets <a href="http://swagger.io">Find out more</a> <h2 id="addpet">addPet</h2> <a id="opIdaddPet"></a> <blockquote> Code samples </blockquote> <pre class="highlight tab tab-shell"><code># You can also use wget curl -X POST http://petstore.swagger.io/v2/pet \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer {access-token}' </code></pre> <pre class="highlight tab tab-http"><code>POST http://petstore.swagger.io/v2/pet HTTP/1.1 Host: petstore.swagger.io Content-Type: application/json </code></pre> <pre class="highlight tab tab-javascript"><code>const inputBody = '{ "id": 0, "category": { "id": 0, "name": "string" }, "name": "doggie", "photoUrls": [ "string" ], "tags": [ { "id": 0, "name": "string" } ], "status": "available" }'; const headers = { 'Content-Type':'application/json', 'Authorization':'Bearer {access-token}' }; fetch('http://petstore.swagger.io/v2/pet', { method: 'POST', body: inputBody, headers: headers }) .then(function(res) { return res.json(); }).then(function(body) { console.log(body); }); </code></pre> <pre class="highlight tab tab-ruby"><code>require 'rest-client' require 'json' headers = { 'Content-Type' => 'application/json', 'Authorization' => 'Bearer {access-token}' } result = RestClient.post 'http://petstore.swagger.io/v2/pet', params: { }, headers: headers p JSON.parse(result) </code></pre> <pre class="highlight tab tab-python"><code>import requests headers = { 'Content-Type': 'application/json', 'Authorization': 'Bearer {access-token}' } r = requests.post('http://petstore.swagger.io/v2/pet', headers = headers) print(r.json()) </code></pre> <pre class="highlight tab tab-php"><code><?php require 'vendor/autoload.php'; $headers = array( 'Content-Type' => 'application/json', 'Authorization' => 'Bearer {access-token}', ); $client = new \GuzzleHttp\Client(); // Define array of request body. $request_body = array(); try { $response = $client->request('POST','http://petstore.swagger.io/v2/pet', array( 'headers' => $headers, 'json' => $request_body, ) ); print_r($response->getBody()->getContents()); } catch (\GuzzleHttp\Exception\BadResponseException $e) { // handle exception or api errors. print_r($e->getMessage()); } // ... </code></pre> <pre class="highlight tab tab-java"><code>URL obj = new URL("http://petstore.swagger.io/v2/pet"); HttpURLConnection con = (HttpURLConnection) obj.openConnection(); con.setRequestMethod("POST"); int responseCode = con.getResponseCode(); BufferedReader in = new BufferedReader( new InputStreamReader(con.getInputStream())); String inputLine; StringBuffer response = new StringBuffer(); while ((inputLine = in.readLine()) != null) { response.append(inputLine); } in.close(); System.out.println(response.toString()); </code></pre> <pre class="highlight tab tab-go"><code>package main import ( "bytes" "net/http" ) func main() { headers := map[string][]string{ "Content-Type": []string{"application/json"}, "Authorization": []string{"Bearer {access-token}"}, } data := bytes.NewBuffer([]byte{jsonReq}) req, err := http.NewRequest("POST", "http://petstore.swagger.io/v2/pet", data) req.Header = headers client := &http.Client{} resp, err := client.Do(req) // ... } </code></pre> <code>POST /pet</code> Add a new pet to the store <blockquote> Body parameter </blockquote> <pre class="highlight tab tab-json"><code>{ "id": 0, "category": { "id": 0, "name": "string" }, "name": "doggie", "photoUrls": [ "string" ], "tags": [ { "id": 0, "name": "string" } ], "status": "available" } </code></pre> <pre class="highlight tab tab-xml"><code><?xml version="1.0" encoding="UTF-8" ?> <Pet> <id>0</id> <category> <id>0</id> <name>string</name> </category> <name>doggie</name> <photoUrls>string</photoUrls> <tags> <id>0</id> <name>string</name> </tags> <status>available</status> </Pet> </code></pre> <h3 id="addpet-parameters">Parameters</h3> <table> <thead> <tr> <th>Name</th> <th>In</th> <th>Type</th> <th>Required</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td>body</td> <td>body</td> <td><a href="#schemapet">Pet</a></td> <td>true</td> <td>Pet object that needs to be added to the store</td> </tr> </tbody> </table> <h3 id="addpet-responses">Responses</h3> <table> <thead> <tr> <th>Status</th> <th>Meaning</th> <th>Description</th> <th>Schema</th> </tr> </thead> <tbody> <tr> <td>405</td> <td><a href="https://tools.ietf.org/html/rfc7231#section-6.5.5">Method Not Allowed</a></td> <td>Invalid input</td> <td>None</td> </tr> </tbody> </table> <aside class="warning"> To perform this operation, you must be authenticated by means of one of the following methods: petstore_auth ( Scopes: write:pets read:pets ) </aside> <h2 id="updatepet">updatePet</h2> <a id="opIdupdatePet"></a> <blockquote> Code samples </blockquote> <pre class="highlight tab tab-shell"><code># You can also use wget curl -X PUT http://petstore.swagger.io/v2/pet \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer {access-token}' </code></pre> <pre class="highlight tab tab-http"><code>PUT http://petstore.swagger.io/v2/pet HTTP/1.1 Host: petstore.swagger.io Content-Type: application/json </code></pre> <pre class="highlight tab tab-javascript"><code>const inputBody = '{ "id": 0, "category": { "id": 0, "name": "string" }, "name": "doggie", "photoUrls": [ "string" ], "tags": [ { "id": 0, "name": "string" } ], "status": "available" }'; const headers = { 'Content-Type':'application/json', 'Authorization':'Bearer {access-token}' }; fetch('http://petstore.swagger.io/v2/pet', { method: 'PUT', body: inputBody, headers: headers }) .then(function(res) { return res.json(); }).then(function(body) { console.log(body); }); </code></pre> <pre class="highlight tab tab-ruby"><code>require 'rest-client' require 'json' headers = { 'Content-Type' => 'application/json', 'Authorization' => 'Bearer {access-token}' } result = RestClient.put 'http://petstore.swagger.io/v2/pet', params: { }, headers: headers p JSON.parse(result) </code></pre> <pre class="highlight tab tab-python"><code>import requests headers = { 'Content-Type': 'application/json', 'Authorization': 'Bearer {access-token}' } r = requests.put('http://petstore.swagger.io/v2/pet', headers = headers) print(r.json()) </code></pre> <pre class="highlight tab tab-php"><code><?php require 'vendor/autoload.php'; $headers = array( 'Content-Type' => 'application/json', 'Authorization' => 'Bearer {access-token}', ); $client = new \GuzzleHttp\Client(); // Define array of request body. $request_body = array(); try { $response = $client->request('PUT','http://petstore.swagger.io/v2/pet', array( 'headers' => $headers, 'json' => $request_body, ) ); print_r($response->getBody()->getContents()); } catch (\GuzzleHttp\Exception\BadResponseException $e) { // handle exception or api errors. print_r($e->getMessage()); } // ... </code></pre> <pre class="highlight tab tab-java"><code>URL obj = new URL("http://petstore.swagger.io/v2/pet"); HttpURLConnection con = (HttpURLConnection) obj.openConnection(); con.setRequestMethod("PUT"); int responseCode = con.getResponseCode(); BufferedReader in = new BufferedReader( new InputStreamReader(con.getInputStream())); String inputLine; StringBuffer response = new StringBuffer(); while ((inputLine = in.readLine()) != null) { response.append(inputLine); } in.close(); System.out.println(response.toString()); </code></pre> <pre class="highlight tab tab-go"><code>package main import ( "bytes" "net/http" ) func main() { headers := map[string][]string{ "Content-Type": []string{"application/json"}, "Authorization": []string{"Bearer {access-token}"}, } data := bytes.NewBuffer([]byte{jsonReq}) req, err := http.NewRequest("PUT", "http://petstore.swagger.io/v2/pet", data) req.Header = headers client := &http.Client{} resp, err := client.Do(req) // ... } </code></pre> <code>PUT /pet</code> Update an existing pet <blockquote> Body parameter </blockquote> <pre class="highlight tab tab-json"><code>{ "id": 0, "category": { "id": 0, "name": "string" }, "name": "doggie", "photoUrls": [ "string" ], "tags": [ { "id": 0, "name": "string" } ], "status": "available" } </code></pre> <pre class="highlight tab tab-xml"><code><?xml version="1.0" encoding="UTF-8" ?> <Pet> <id>0</id> <category> <id>0</id> <name>string</name> </category> <name>doggie</name> <photoUrls>string</photoUrls> <tags> <id>0</id> <name>string</name> </tags> <status>available</status> </Pet> </code></pre> <h3 id="updatepet-parameters">Parameters</h3> <table> <thead> <tr> <th>Name</th> <th>In</th> <th>Type</th> <th>Required</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td>body</td> <td>body</td> <td><a href="#schemapet">Pet</a></td> <td>true</td> <td>Pet object that needs to be added to the store</td> </tr> </tbody> </table> <h3 id="updatepet-responses">Responses</h3> <table> <thead> <tr> <th>Status</th> <th>Meaning</th> <th>Description</th> <th>Schema</th> </tr> </thead> <tbody> <tr> <td>400</td> <td><a href="https://tools.ietf.org/html/rfc7231#section-6.5.1">Bad Request</a></td> <td>Invalid ID supplied</td> <td>None</td> </tr> <tr> <td>404</td> <td><a href="https://tools.ietf.org/html/rfc7231#section-6.5.4">Not Found</a></td> <td>Pet not found</td> <td>None</td> </tr> <tr> <td>405</td> <td><a href="https://tools.ietf.org/html/rfc7231#section-6.5.5">Method Not Allowed</a></td> <td>Validation exception</td> <td>None</td> </tr> </tbody> </table> <aside class="warning"> To perform this operation, you must be authenticated by means of one of the following methods: petstore_auth ( Scopes: write:pets read:pets ) </aside> <h2 id="findpetsbystatus">findPetsByStatus</h2> <a id="opIdfindPetsByStatus"></a> <blockquote> Code samples </blockquote> <pre class="highlight tab tab-shell"><code># You can also use wget curl -X GET http://petstore.swagger.io/v2/pet/findByStatus?status=available \ -H 'Accept: application/xml' \ -H 'Authorization: Bearer {access-token}' </code></pre> <pre class="highlight tab tab-http"><code>GET http://petstore.swagger.io/v2/pet/findByStatus?status=available HTTP/1.1 Host: petstore.swagger.io Accept: application/xml </code></pre> <pre class="highlight tab tab-javascript"><code> const headers = { 'Accept':'application/xml', 'Authorization':'Bearer {access-token}' }; fetch('http://petstore.swagger.io/v2/pet/findByStatus?status=available', { method: 'GET', headers: headers }) .then(function(res) { return res.json(); }).then(function(body) { console.log(body); }); </code></pre> <pre class="highlight tab tab-ruby"><code>require 'rest-client' require 'json' headers = { 'Accept' => 'application/xml', 'Authorization' => 'Bearer {access-token}' } result = RestClient.get 'http://petstore.swagger.io/v2/pet/findByStatus', params: { 'status' => 'array[string]' }, headers: headers p JSON.parse(result) </code></pre> <pre class="highlight tab tab-python"><code>import requests headers = { 'Accept': 'application/xml', 'Authorization': 'Bearer {access-token}' } r = requests.get('http://petstore.swagger.io/v2/pet/findByStatus', params={ 'status': [ "available" ] }, headers = headers) print(r.json()) </code></pre> <pre class="highlight tab tab-php"><code><?php require 'vendor/autoload.php'; $headers = array( 'Accept' => 'application/xml', 'Authorization' => 'Bearer {access-token}', ); $client = new \GuzzleHttp\Client(); // Define array of request body. $request_body = array(); try { $response = $client->request('GET','http://petstore.swagger.io/v2/pet/findByStatus', array( 'headers' => $headers, 'json' => $request_body, ) ); print_r($response->getBody()->getContents()); } catch (\GuzzleHttp\Exception\BadResponseException $e) { // handle exception or api errors. print_r($e->getMessage()); } // ... </code></pre> <pre class="highlight tab tab-java"><code>URL obj = new URL("http://petstore.swagger.io/v2/pet/findByStatus?status=available"); HttpURLConnection con = (HttpURLConnection) obj.openConnection(); con.setRequestMethod("GET"); int responseCode = con.getResponseCode(); BufferedReader in = new BufferedReader( new InputStreamReader(con.getInputStream())); String inputLine; StringBuffer response = new StringBuffer(); while ((inputLine = in.readLine()) != null) { response.append(inputLine); } in.close(); System.out.println(response.toString()); </code></pre> <pre class="highlight tab tab-go"><code>package main import ( "bytes" "net/http" ) func main() { headers := map[string][]string{ "Accept": []string{"application/xml"}, "Authorization": []string{"Bearer {access-token}"}, } data := bytes.NewBuffer([]byte{jsonReq}) req, err := http.NewRequest("GET", "http://petstore.swagger.io/v2/pet/findByStatus", data) req.Header = headers client := &http.Client{} resp, err := client.Do(req) // ... } </code></pre> <code>GET /pet/findByStatus</code> Finds Pets by status Multiple status values can be provided with comma separated strings <h3 id="findpetsbystatus-parameters">Parameters</h3> <table> <thead> <tr> <th>Name</th> <th>In</th> <th>Type</th> <th>Required</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td>status</td> <td>query</td> <td>array[string]</td> <td>true</td> <td>Status values that need to be considered for filter</td> </tr> </tbody> </table> <h4 id="enumerated-values">Enumerated Values</h4> <table> <thead> <tr> <th>Parameter</th> <th>Value</th> </tr> </thead> <tbody> <tr> <td>status</td> <td>available</td> </tr> <tr> <td>status</td> <td>pending</td> </tr> <tr> <td>status</td> <td>sold</td> </tr> </tbody> </table> <blockquote> Example responses </blockquote> <blockquote> 200 Response </blockquote> <pre class="highlight tab tab-xml"><code><?xml version="1.0" encoding="UTF-8" ?> <id>0</id> <category> <id>0</id> <name>string</name> </category> <name>doggie</name> <photoUrls>string</photoUrls> <tags> <id>0</id> <name>string</name> </tags> <status>available</status> </code></pre> <pre class="highlight tab tab-json"><code>[ { "id": 0, "category": { "id": 0, "name": "string" }, "name": "doggie", "photoUrls": [ "string" ], "tags": [ { "id": 0, "name": "string" } ], "status": "available" } ] </code></pre> <h3 id="findpetsbystatus-responses">Responses</h3> <table> <thead> <tr> <th>Status</th> <th>Meaning</th> <th>Description</th> <th>Schema</th> </tr> </thead> <tbody> <tr> <td>200</td> <td><a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">OK</a></td> <td>successful operation</td> <td>Inline</td> </tr> <tr> <td>400</td> <td><a href="https://tools.ietf.org/html/rfc7231#section-6.5.1">Bad Request</a></td> <td>Invalid status value</td> <td>None</td> </tr> </tbody> </table> <h3 id="findpetsbystatus-responseschema">Response Schema</h3> Status Code 200 <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Required</th> <th>Restrictions</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td>anonymous</td> <td>[<a href="#schemapet">Pet</a>]</td> <td>false</td> <td>none</td> <td>none</td> </tr> <tr> <td>» id</td> <td>integer(int64)</td> <td>false</td> <td>none</td> <td>none</td> </tr> <tr> <td>» category</td> <td><a href="#schemacategory">Category</a></td> <td>false</td> <td>none</td> <td>none</td> </tr> <tr> <td>»» id</td> <td>integer(int64)</td> <td>false</td> <td>none</td> <td>none</td> </tr> <tr> <td>»» name</td> <td>string</td> <td>false</td> <td>none</td> <td>none</td> </tr> <tr> <td>» name</td> <td>string</td> <td>true</td> <td>none</td> <td>none</td> </tr> <tr> <td>» photoUrls</td> <td>[string]</td> <td>true</td> <td>none</td> <td>none</td> </tr> <tr> <td>» tags</td> <td>[<a href="#schematag">Tag</a>]</td> <td>false</td> <td>none</td> <td>none</td> </tr> <tr> <td>»» id</td> <td>integer(int64)</td> <td>false</td> <td>none</td> <td>none</td> </tr> <tr> <td>»» name</td> <td>string</td> <td>false</td> <td>none</td> <td>none</td> </tr> <tr> <td>» status</td> <td>string</td> <td>false</td> <td>none</td> <td>pet status in the store</td> </tr> </tbody> </table> <h4 id="enumerated-values-2">Enumerated Values</h4> <table> <thead> <tr> <th>Property</th> <th>Value</th> </tr> </thead> <tbody> <tr> <td>status</td> <td>available</td> </tr> <tr> <td>status</td> <td>pending</td> </tr> <tr> <td>status</td> <td>sold</td> </tr> </tbody> </table> <aside class="warning"> To perform this operation, you must be authenticated by means of one of the following methods: petstore_auth ( Scopes: write:pets read:pets ) </aside> <h2 id="findpetsbytags">findPetsByTags</h2> <a id="opIdfindPetsByTags"></a> <blockquote> Code samples </blockquote> <pre class="highlight tab tab-shell"><code># You can also use wget curl -X GET http://petstore.swagger.io/v2/pet/findByTags?tags=string \ -H 'Accept: application/xml' \ -H 'Authorization: Bearer {access-token}' </code></pre> <pre class="highlight tab tab-http"><code>GET http://petstore.swagger.io/v2/pet/findByTags?tags=string HTTP/1.1 Host: petstore.swagger.io Accept: application/xml </code></pre> <pre class="highlight tab tab-javascript"><code> const headers = { 'Accept':'application/xml', 'Authorization':'Bearer {access-token}' }; fetch('http://petstore.swagger.io/v2/pet/findByTags?tags=string', { method: 'GET', headers: headers }) .then(function(res) { return res.json(); }).then(function(body) { console.log(body); }); </code></pre> <pre class="highlight tab tab-ruby"><code>require 'rest-client' require 'json' headers = { 'Accept' => 'application/xml', 'Authorization' => 'Bearer {access-token}' } result = RestClient.get 'http://petstore.swagger.io/v2/pet/findByTags', params: { 'tags' => 'array[string]' }, headers: headers p JSON.parse(result) </code></pre> <pre class="highlight tab tab-python"><code>import requests headers = { 'Accept': 'application/xml', 'Authorization': 'Bearer {access-token}' } r = requests.get('http://petstore.swagger.io/v2/pet/findByTags', params={ 'tags': [ "string" ] }, headers = headers) print(r.json()) </code></pre> <pre class="highlight tab tab-php"><code><?php require 'vendor/autoload.php'; $headers = array( 'Accept' => 'application/xml', 'Authorization' => 'Bearer {access-token}', ); $client = new \GuzzleHttp\Client(); // Define array of request body. $request_body = array(); try { $response = $client->request('GET','http://petstore.swagger.io/v2/pet/findByTags', array( 'headers' => $headers, 'json' => $request_body, ) ); print_r($response->getBody()->getContents()); } catch (\GuzzleHttp\Exception\BadResponseException $e) { // handle exception or api errors. print_r($e->getMessage()); } // ... </code></pre> <pre class="highlight tab tab-java"><code>URL obj = new URL("http://petstore.swagger.io/v2/pet/findByTags?tags=string"); HttpURLConnection con = (HttpURLConnection) obj.openConnection(); con.setRequestMethod("GET"); int responseCode = con.getResponseCode(); BufferedReader in = new BufferedReader( new InputStreamReader(con.getInputStream())); String inputLine; StringBuffer response = new StringBuffer(); while ((inputLine = in.readLine()) != null) { response.append(inputLine); } in.close(); System.out.println(response.toString()); </code></pre> <pre class="highlight tab tab-go"><code>package main import ( "bytes" "net/http" ) fu