openapi-generator/samples/client/petstore/javascript-promise/README.md

6.3 KiB

swagger-petstore

SwaggerPetstore - JavaScript client for swagger-petstore This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. This SDK is automatically generated by the Swagger Codegen project:

  • API version: 1.0.0
  • Package version: 1.0.0
  • Build date: 2016-05-06T17:51:36.114+08:00
  • Build package: class io.swagger.codegen.languages.JavascriptClientCodegen

Installation

For Node.js

npm

To publish the library as a npm, please follow the procedure in "Publishing npm packages".

Then install it via:

npm install swagger-petstore --save

git

If the library is hosted at a git repository, e.g. https://github.com/GIT_USER_ID/GIT_REPO_ID then install it via:

    npm install GIT_USER_ID/GIT_REPO_ID --save

For browser

The library also works in the browser environment via npm and browserify. After following the above steps with Node.js and installing browserify with npm install -g browserify, perform the following (assuming main.js is your entry file):

browserify main.js > bundle.js

Then include bundle.js in the HTML pages.

Getting Started

Please follow the installation instruction and execute the following JS code:

var SwaggerPetstore = require('swagger-petstore');

var api = new SwaggerPetstore.FakeApi()

var _number = 3.4; // {Number} None

var _double = 1.2; // {Number} None

var _string = "_string_example"; // {String} None

var _byte = "B"; // {String} None

var opts = { 
  'integer': 56, // {Integer} None
  'int32': 56, // {Integer} None
  'int64': 789, // {Integer} None
  '_float': 3.4, // {Number} None
  'binary': "B", // {String} None
  '_date': new Date("2013-10-20"), // {Date} None
  'dateTime': new Date("2013-10-20T19:20:30+01:00"), // {Date} None
  'password': "password_example" // {String} None
};
api.testEndpointParameters(_number, _double, _string, _byte, opts).then(function() {
  console.log('API called successfully.');
}, function(error) {
  console.error(error);
});


Documentation for API Endpoints

All URIs are relative to http://petstore.swagger.io/v2

Class Method HTTP request Description
SwaggerPetstore.FakeApi testEndpointParameters POST /fake Fake endpoint for testing various parameters
SwaggerPetstore.PetApi addPet POST /pet Add a new pet to the store
SwaggerPetstore.PetApi deletePet DELETE /pet/{petId} Deletes a pet
SwaggerPetstore.PetApi findPetsByStatus GET /pet/findByStatus Finds Pets by status
SwaggerPetstore.PetApi findPetsByTags GET /pet/findByTags Finds Pets by tags
SwaggerPetstore.PetApi getPetById GET /pet/{petId} Find pet by ID
SwaggerPetstore.PetApi updatePet PUT /pet Update an existing pet
SwaggerPetstore.PetApi updatePetWithForm POST /pet/{petId} Updates a pet in the store with form data
SwaggerPetstore.PetApi uploadFile POST /pet/{petId}/uploadImage uploads an image
SwaggerPetstore.StoreApi deleteOrder DELETE /store/order/{orderId} Delete purchase order by ID
SwaggerPetstore.StoreApi getInventory GET /store/inventory Returns pet inventories by status
SwaggerPetstore.StoreApi getOrderById GET /store/order/{orderId} Find purchase order by ID
SwaggerPetstore.StoreApi placeOrder POST /store/order Place an order for a pet
SwaggerPetstore.UserApi createUser POST /user Create user
SwaggerPetstore.UserApi createUsersWithArrayInput POST /user/createWithArray Creates list of users with given input array
SwaggerPetstore.UserApi createUsersWithListInput POST /user/createWithList Creates list of users with given input array
SwaggerPetstore.UserApi deleteUser DELETE /user/{username} Delete user
SwaggerPetstore.UserApi getUserByName GET /user/{username} Get user by user name
SwaggerPetstore.UserApi loginUser GET /user/login Logs user into the system
SwaggerPetstore.UserApi logoutUser GET /user/logout Logs out current logged in user session
SwaggerPetstore.UserApi updateUser PUT /user/{username} Updated user

Documentation for Models

Documentation for Authorization

petstore_auth

api_key

  • Type: API key
  • API key parameter name: api_key
  • Location: HTTP header