valitydev/openapi-generator
14
0
Fork 0
mirror of https://github.com/valitydev/openapi-generator.git synced 2024-11-07 19:08:52 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
4854b79a31
openapi-generator/samples/client/petstore/ruby
History
wing328 4854b79a31 add pattern check to ruby model
2016-04-25 22:23:23 +08:00
..
docs add validation to ruby model 2016-04-25 17:07:42 +08:00
lib add pattern check to ruby model 2016-04-25 22:23:23 +08:00
spec add more validation test for ruby model 2016-04-25 17:36:32 +08:00
.gitignore Ruby: add auto-generated documentation in Markdown 2016-03-09 17:18:15 +08:00
Gemfile added ruby sample 2012-09-26 13:02:27 -07:00
Gemfile.lock add validation to ruby model 2016-04-25 17:07:42 +08:00
git_push.sh fix perl, ruby auth doc in readme 2016-03-16 14:58:19 +08:00
hello.txt Add file used in test: hello.txt 2015-08-20 11:18:05 +08:00
petstore_profiling.output Add profiling script and results for Ruby Petstore sample 2015-12-11 23:24:19 +08:00
petstore_profiling.rb Add profiling script and results for Ruby Petstore sample 2015-12-11 23:24:19 +08:00
petstore.gemspec add default value to gem spec 2016-04-20 18:49:29 +08:00
pom.xml Code reformatting 2015-06-07 11:56:08 -04:00
press_anykey_to_continue.sh add delay script, update CI test to run ruby test first 2016-02-12 18:46:19 +08:00
Rakefile added ruby sample 2012-09-26 13:02:27 -07:00
README.md add pattern check to ruby model 2016-04-25 22:23:23 +08:00

README.md

petstore

Petstore - the Ruby gem for the 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-04-25T22:22:56.750+08:00
  • Build package: class io.swagger.codegen.languages.RubyClientCodegen

Installation

Build a gem

To build the Ruby code into a gem:

gem build petstore.gemspec

Then either install the gem locally:

gem install ./petstore-1.0.0.gem

(for development, run gem install --dev ./petstore-1.0.0.gem to install the development dependencies)

or publish the gem to a gem hosting service, e.g. RubyGems.

Finally add this to the Gemfile:

gem 'petstore', '~> 1.0.0'

Install from Git

If the Ruby gem is hosted at a git repository: https://github.com/YOUR_GIT_USR_ID/YOUR_GIT_REPO_ID, then add the following in the Gemfile:

gem 'petstore', :git => 'https://github.com/YOUR_GIT_USR_ID/YOUR_GIT_REPO_ID.git'

Include the Ruby code directly

Include the Ruby code directly using -I as follows:

ruby -Ilib script.rb

Getting Started

Please follow the installation procedure and then run the following code:

# Load the gem
require 'petstore'

# Setup authorization
Petstore.configure do |config|
  # Configure OAuth2 access token for authorization: petstore_auth
  config.access_token = 'YOUR ACCESS TOKEN'
end

api_instance = Petstore::PetApi.new

body = Petstore::Pet.new # Pet | Pet object that needs to be added to the store


begin
  #Add a new pet to the store
  api_instance.add_pet(body)
rescue Petstore::ApiError => e
  puts "Exception when calling PetApi->add_pet: #{e}"
end

Documentation for API Endpoints

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

Class Method HTTP request Description
Petstore::PetApi add_pet POST /pet Add a new pet to the store
Petstore::PetApi delete_pet DELETE /pet/{petId} Deletes a pet
Petstore::PetApi find_pets_by_status GET /pet/findByStatus Finds Pets by status
Petstore::PetApi find_pets_by_tags GET /pet/findByTags Finds Pets by tags
Petstore::PetApi get_pet_by_id GET /pet/{petId} Find pet by ID
Petstore::PetApi update_pet PUT /pet Update an existing pet
Petstore::PetApi update_pet_with_form POST /pet/{petId} Updates a pet in the store with form data
Petstore::PetApi upload_file POST /pet/{petId}/uploadImage uploads an image
Petstore::StoreApi delete_order DELETE /store/order/{orderId} Delete purchase order by ID
Petstore::StoreApi get_inventory GET /store/inventory Returns pet inventories by status
Petstore::StoreApi get_order_by_id GET /store/order/{orderId} Find purchase order by ID
Petstore::StoreApi place_order POST /store/order Place an order for a pet
Petstore::UserApi create_user POST /user Create user
Petstore::UserApi create_users_with_array_input POST /user/createWithArray Creates list of users with given input array
Petstore::UserApi create_users_with_list_input POST /user/createWithList Creates list of users with given input array
Petstore::UserApi delete_user DELETE /user/{username} Delete user
Petstore::UserApi get_user_by_name GET /user/{username} Get user by user name
Petstore::UserApi login_user GET /user/login Logs user into the system
Petstore::UserApi logout_user GET /user/logout Logs out current logged in user session
Petstore::UserApi update_user PUT /user/{username} Updated user

Documentation for Models

Documentation for Authorization

api_key

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

petstore_auth