openapi-generator/samples/client/petstore/ruby/docs/StoreApi.md

Petstore::StoreApi

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

Method	HTTP request	Description
delete_order	DELETE /store/order/{orderId}	Delete purchase order by ID
find_orders_by_status	GET /store/findByStatus	Finds orders by status
get_inventory	GET /store/inventory	Returns pet inventories by status
get_inventory_in_object	GET /store/inventory?response=arbitrary_object	Fake endpoint to test arbitrary object return by 'Get inventory'
get_order_by_id	GET /store/order/{orderId}	Find purchase order by ID
place_order	POST /store/order	Place an order for a pet

delete_order

delete_order(order_id)

Delete purchase order by ID

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

Example

require 'petstore'

api = Petstore::StoreApi.new

order_id = "order_id_example" # [String] ID of the order that needs to be deleted


begin
  api.delete_order(order_id)
rescue Petstore::ApiError => e
  puts "Exception when calling delete_order: #{e}"
end

Parameters

Name	Type	Description	Notes
order_id	String	ID of the order that needs to be deleted

Return type

nil (empty response body)

Authorization

No authorization required

HTTP reuqest headers

• Content-Type: Not defined
• Accept: application/json, application/xml

find_orders_by_status

Array<Order> find_orders_by_status(opts)

Finds orders by status

A single status value can be provided as a string

Example

require 'petstore'

Petstore.configure do |config|
  # Configure API key authorization: test_api_client_id
  config.api_key['x-test_api_client_id'] = "YOUR API KEY"
  # Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to nil)
  #config.api_key_prefix['x-test_api_client_id'] = "Token"

  # Configure API key authorization: test_api_client_secret
  config.api_key['x-test_api_client_secret'] = "YOUR API KEY"
  # Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to nil)
  #config.api_key_prefix['x-test_api_client_secret'] = "Token"
end

api = Petstore::StoreApi.new

opts = { 
  status: "placed" # [String] Status value that needs to be considered for query
}

begin
  result = api.find_orders_by_status(opts)
  p result
rescue Petstore::ApiError => e
  puts "Exception when calling find_orders_by_status: #{e}"
end

Parameters

Name	Type	Description	Notes
status	String	Status value that needs to be considered for query	[optional] [default to placed]

Return type

Array<Order>

Authorization

test_api_client_id, test_api_client_secret

HTTP reuqest headers

• Content-Type: Not defined
• Accept: application/json, application/xml

get_inventory

Hash<String, Integer> get_inventory

Returns pet inventories by status

Returns a map of status codes to quantities

Example

require 'petstore'

Petstore.configure do |config|
  # Configure API key authorization: api_key
  config.api_key['api_key'] = "YOUR API KEY"
  # Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to nil)
  #config.api_key_prefix['api_key'] = "Token"
end

api = Petstore::StoreApi.new

begin
  result = api.get_inventory
  p result
rescue Petstore::ApiError => e
  puts "Exception when calling get_inventory: #{e}"
end

Parameters

This endpoint does not need any parameter.

Return type

Hash<String, Integer>

Authorization

api_key

HTTP reuqest headers

• Content-Type: Not defined
• Accept: application/json, application/xml

get_inventory_in_object

Object get_inventory_in_object

Fake endpoint to test arbitrary object return by 'Get inventory'

Returns an arbitrary object which is actually a map of status codes to quantities

Example

require 'petstore'

Petstore.configure do |config|
  # Configure API key authorization: api_key
  config.api_key['api_key'] = "YOUR API KEY"
  # Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to nil)
  #config.api_key_prefix['api_key'] = "Token"
end

api = Petstore::StoreApi.new

begin
  result = api.get_inventory_in_object
  p result
rescue Petstore::ApiError => e
  puts "Exception when calling get_inventory_in_object: #{e}"
end

Parameters

This endpoint does not need any parameter.

Return type

Object

Authorization

api_key

HTTP reuqest headers

• Content-Type: Not defined
• Accept: application/json, application/xml

get_order_by_id

Order get_order_by_id(order_id)

Find purchase order by ID

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

Example

require 'petstore'

Petstore.configure do |config|
  # Configure API key authorization: test_api_key_header
  config.api_key['test_api_key_header'] = "YOUR API KEY"
  # Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to nil)
  #config.api_key_prefix['test_api_key_header'] = "Token"

  # Configure API key authorization: test_api_key_query
  config.api_key['test_api_key_query'] = "YOUR API KEY"
  # Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to nil)
  #config.api_key_prefix['test_api_key_query'] = "Token"
end

api = Petstore::StoreApi.new

order_id = "order_id_example" # [String] ID of pet that needs to be fetched


begin
  result = api.get_order_by_id(order_id)
  p result
rescue Petstore::ApiError => e
  puts "Exception when calling get_order_by_id: #{e}"
end

Parameters

Name	Type	Description	Notes
order_id	String	ID of pet that needs to be fetched

Return type

Order

Authorization

test_api_key_header, test_api_key_query

HTTP reuqest headers

• Content-Type: Not defined
• Accept: application/json, application/xml

place_order

Order place_order(opts)

Place an order for a pet

Example

require 'petstore'

Petstore.configure do |config|
  # Configure API key authorization: test_api_client_id
  config.api_key['x-test_api_client_id'] = "YOUR API KEY"
  # Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to nil)
  #config.api_key_prefix['x-test_api_client_id'] = "Token"

  # Configure API key authorization: test_api_client_secret
  config.api_key['x-test_api_client_secret'] = "YOUR API KEY"
  # Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to nil)
  #config.api_key_prefix['x-test_api_client_secret'] = "Token"
end

api = Petstore::StoreApi.new

opts = { 
  body: Petstore::Order.new # [Order] order placed for purchasing the pet
}

begin
  result = api.place_order(opts)
  p result
rescue Petstore::ApiError => e
  puts "Exception when calling place_order: #{e}"
end

Parameters

Name	Type	Description	Notes
body	Order	order placed for purchasing the pet	[optional]

Return type

Order

Authorization

test_api_client_id, test_api_client_secret

HTTP reuqest headers

• Content-Type: Not defined
• Accept: application/json, application/xml