GitHub - gonebusy/gonebusy-ruby-client: A Ruby SDK for access to the Gonebusy API

Getting started

Sandbox

We have a Sandbox environment to play with!

Just use sandbox.gonebusy.com instead of where you see beta.gonebusy.com referenced, including where to create an account to retrieve your API Key.

The Sandbox environment is completely separate from the Live site - that includes meaning your Sandbox API Key will not work in the Live environment.

How to Build

This client library is a Ruby gem which can be compiled and used in your Ruby and Ruby on Rails project. This library requires a few gems from the RubyGems repository.

Open the command line interface or the terminal and navigate to the folder containing the source code.
Run gem build gonebusy.gemspec to build the gem.
Once built, the gem can be installed on the current work environment using gem install gonebusy-0.1.3.gem

How to Use

API Key

If testing with Sandbox, Signup/Logon at https://sandbox.gonebusy.com/login.

If using Production site, Signup/Logon at https://beta.gonebusy.com/login.

Once logged in, navigate to the API Key page and request an API key.

Initialization/Authentication

In order to setup authentication and initialization of the API client, you need the following information.

Parameter	Description
authorization	Set Authorization to "Token your API key"

API client can be initialized as following.

# Configuration parameters and credentials
authorization = "Token <your API key>"; # Set Authorization to "Token <your API key>"

client = Gonebusy::GonebusyClient.new(authorization)

How to Test

You can test the generated SDK and the server with automatically generated test cases as follows:

From terminal/cmd navigate to the root directory of the SDK.
Invoke: bundle exec rake

Class Reference

BookingsController

Get singleton instance

The singleton instance of the BookingsController class can be accessed from the API Client.

bookings = client.bookings

create_booking

Create a Booking with params

def create_booking(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
create_booking_body	`Required`	the content of the request

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

create_booking_body = CreateBookingBody.new
collect['create_booking_body'] = create_booking_body


result = bookings.create_booking(collect)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
422	Unprocessable Entity
500	Unexpected error

get_bookings

Return list of Bookings.

def get_bookings(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
page	`Optional` `DefaultValue`	Page offset to fetch.
per_page	`Optional` `DefaultValue`	Number of results to return per page.
states	`Optional`	Comma-separated list of Booking states to retrieve only Bookings in those states. Leave blank to retrieve all Bookings.
user_id	`Optional`	Retrieve Bookings for Resources/Services owned by this User Id. You must be authorized to manage this User Id.
booker_id	`Optional`	Retrieve Bookings make by Booker Id.

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

page = 1
collect['page'] = page

per_page = 10
collect['per_page'] = per_page

states = 'states'
collect['states'] = states

user_id = 86
collect['user_id'] = user_id


result = bookings.get_bookings(collect)

Errors

Error Code	Error Description
401	Unauthorized/Missing Token
403	Forbidden
404	Not Found
500	Unexpected error

cancel_booking_by_id

Cancel a Booking by id

def cancel_booking_by_id(authorization,
                             id,
                             cancel_recurring = nil,
                             date = nil,
                             end_date = nil); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
id	`Required`	TODO: Add a parameter description
cancel_recurring	`Optional`	When a recurring booking, one of: ['instance', 'all', 'infinite']
date	`Optional`	If a recurring booking, the date of an instance to cancel. Several formats are supported: '2014-10-31', 'October 31, 2014'
end_date	`Optional`	If recurring, cancel up to :end_date or leave blank for infinite booking. Several formats are supported: '2014-10-31', 'October 31, 2014'.

Example Usage

authorization = 'Authorization'
id = 'id'
cancel_recurring = 'cancel_recurring'
date = DateTime.now
end_date = DateTime.now

result = bookings.cancel_booking_by_id(authorization, id, cancel_recurring, date, end_date)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
404	Not Found
500	Unexpected error

update_booking_by_id

Update a Booking by id

def update_booking_by_id(authorization,
                             id,
                             update_booking_by_id_body = nil); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
id	`Required`	TODO: Add a parameter description
update_booking_by_id_body	`Optional`	the content of the request

Example Usage

authorization = 'Authorization'
id = 'id'
update_booking_by_id_body = UpdateBookingByIdBody.new

result = bookings.update_booking_by_id(authorization, id, update_booking_by_id_body)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
404	Not Found
422	Unprocessable Entity
500	Unexpected error

get_booking_by_id

Return a Booking by id.

def get_booking_by_id(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
id	`Required`	TODO: Add a parameter description

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

id = 'id'
collect['id'] = id


result = bookings.get_booking_by_id(collect)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
404	Not Found
500	Unexpected error

Back to List of Controllers

UsersController

Get singleton instance

The singleton instance of the UsersController class can be accessed from the API Client.

users = client.users

update_user_by_id

Update a User by id, with params.

def update_user_by_id(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
id	`Required`	TODO: Add a parameter description
update_user_by_id_body	`Required`	the content of the request

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

id = 'id'
collect['id'] = id

update_user_by_id_body = UpdateUserByIdBody.new
collect['update_user_by_id_body'] = update_user_by_id_body


result = users.update_user_by_id(collect)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
404	Not Found
422	Unprocessable Entity
500	Unexpected error

get_user_by_id

Return a User by id.

def get_user_by_id(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
id	`Required`	TODO: Add a parameter description

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

id = 'id'
collect['id'] = id


result = users.get_user_by_id(collect)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
404	Not Found
500	Unexpected error

get_users_pros

Return list of active Pro Users.

def get_users_pros(authorization); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'

Example Usage

authorization = 'Authorization'

result = users.get_users_pros(authorization)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
500	Unexpected error

create_user

Create a User

def create_user(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
create_user_body	`Required`	the content of the request

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

create_user_body = CreateUserBody.new
collect['create_user_body'] = create_user_body


result = users.create_user(collect)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
422	Unprocessable Entity
500	Unexpected error

get_users

Return all Users that your account has access to. Includes your own User as well as any Users for which you are the Account Manager.

def get_users(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
page	`Optional` `DefaultValue`	Page offset to fetch.
per_page	`Optional` `DefaultValue`	Number of results to return per page.

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

page = 1
collect['page'] = page

per_page = 10
collect['per_page'] = per_page


result = users.get_users(collect)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
500	Unexpected error

Back to List of Controllers

ServicesController

Get singleton instance

The singleton instance of the ServicesController class can be accessed from the API Client.

services = client.services

delete_service_by_id

Delete a Service by id

def delete_service_by_id(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
id	`Required`	TODO: Add a parameter description

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

id = 'id'
collect['id'] = id


result = services.delete_service_by_id(collect)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
404	Not Found
500	Unexpected error

update_service_by_id

Update a Service with params.

def update_service_by_id(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
id	`Required`	TODO: Add a parameter description
update_service_by_id_body	`Required`	the content of the request

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

id = 'id'
collect['id'] = id

update_service_by_id_body = UpdateServiceByIdBody.new
collect['update_service_by_id_body'] = update_service_by_id_body


result = services.update_service_by_id(collect)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
404	Not Found
422	Unprocessable Entity
500	Unexpected error

get_service_by_id

Return a Service by id.

def get_service_by_id(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
id	`Required`	TODO: Add a parameter description

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

id = 'id'
collect['id'] = id


result = services.get_service_by_id(collect)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
404	Not Found
500	Unexpected error

create_service

Create a Service with params.

def create_service(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
create_service_body	`Required`	the content of the request

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

create_service_body = CreateServiceBody.new
collect['create_service_body'] = create_service_body


result = services.create_service(collect)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
404	Not Found
422	Unprocessable Entity
500	Unexpected error

get_services

Return list of Services.

def get_services(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
page	`Optional` `DefaultValue`	Page offset to fetch.
per_page	`Optional` `DefaultValue`	Number of results to return per page.
user_id	`Optional`	Retrieve Services provided by the User specified by Id. You must be authorized to manage this User Id.

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

page = 1
collect['page'] = page

per_page = 10
collect['per_page'] = per_page

user_id = 45
collect['user_id'] = user_id


result = services.get_services(collect)

Errors

Error Code	Error Description
401	Unauthorized/Missing Token
403	Forbidden
404	Not Found
500	Unexpected error

get_service_available_slots_by_id

Return available times for a Service.

def get_service_available_slots_by_id(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
id	`Required`	TODO: Add a parameter description
date	`Optional`	Date to check for availability. Either this field or a date range employing start_date and end_date must be supplied. If date is provided, start_date/end_date are ignored. Several formats are supported: '2014-10-31', 'October 31, 2014'.
end_date	`Optional`	End Date of a range to check for availability. If supplied, date must not be supplied and start_date must be supplied. Several formats are supported: '2014-10-31', 'October 31, 2014'.
start_date	`Optional`	Start Date of a range to check for availability. If supplied, date must not be supplied and end_date must be supplied. Several formats are supported: '2014-10-31', 'October 31, 2014'.

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

id = 'id'
collect['id'] = id

date = DateTime.now
collect['date'] = date

end_date = DateTime.now
collect['end_date'] = end_date

start_date = DateTime.now
collect['start_date'] = start_date


result = services.get_service_available_slots_by_id(collect)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
404	Not Found
500	Unexpected error

Back to List of Controllers

SearchController

Get singleton instance

The singleton instance of the SearchController class can be accessed from the API Client.

search = client.search

search_query

Search for Providers and Provided Services.

def search_query(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
query	`Required`	TODO: Add a parameter description

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

query = 'query'
collect['query'] = query


result = search.search_query(collect)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
500	Unexpected error

Back to List of Controllers

SchedulesController

Get singleton instance

The singleton instance of the SchedulesController class can be accessed from the API Client.

schedules = client.schedules

delete_schedule_time_window_by_id

Delete a TimeWindow from a Schedule

def delete_schedule_time_window_by_id(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
id	`Required`	TODO: Add a parameter description
time_window_id	`Required`	TODO: Add a parameter description

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

id = 'id'
collect['id'] = id

time_window_id = 'time_window_id'
collect['time_window_id'] = time_window_id


result = schedules.delete_schedule_time_window_by_id(collect)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
404	Not Found
500	Unexpected error

create_schedule_time_window

Add a TimeWindow to a Schedule.

def create_schedule_time_window(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
create_schedule_time_window_body	`Required`	the content of the request
id	`Required`	TODO: Add a parameter description

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

create_schedule_time_window_body = CreateScheduleTimeWindowBody.new
collect['create_schedule_time_window_body'] = create_schedule_time_window_body

id = 'id'
collect['id'] = id


result = schedules.create_schedule_time_window(collect)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
404	Not Found
422	Unprocessable Entity
500	Unexpected error

delete_schedule_by_id

Delete a Schedule

def delete_schedule_by_id(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
id	`Required`	TODO: Add a parameter description

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

id = 'id'
collect['id'] = id


result = schedules.delete_schedule_by_id(collect)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
404	Not Found
500	Unexpected error

get_schedule_by_id

Return a Schedule by id.

def get_schedule_by_id(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
id	`Required`	TODO: Add a parameter description

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

id = 'id'
collect['id'] = id


result = schedules.get_schedule_by_id(collect)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
404	Not Found
410	Gone
500	Unexpected error

create_schedule

Create a Schedule with params.

def create_schedule(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
create_schedule_body	`Required`	the content of the request

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

create_schedule_body = CreateScheduleBody.new
collect['create_schedule_body'] = create_schedule_body


result = schedules.create_schedule(collect)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
404	Not Found
422	Unprocessable Entity
500	Unexpected error

update_schedule_time_window_by_id

Update a TimeWindow for a Schedule.

def update_schedule_time_window_by_id(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
id	`Required`	TODO: Add a parameter description
time_window_id	`Required`	TODO: Add a parameter description
update_schedule_time_window_by_id_body	`Required`	the content of the request

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

id = 'id'
collect['id'] = id

time_window_id = 'time_window_id'
collect['time_window_id'] = time_window_id

update_schedule_time_window_by_id_body = UpdateScheduleTimeWindowByIdBody.new
collect['update_schedule_time_window_by_id_body'] = update_schedule_time_window_by_id_body


result = schedules.update_schedule_time_window_by_id(collect)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
404	Not Found
422	Unprocessable Entity
500	Unexpected error

get_schedules

Return all Schedules that your account has access to. Includes Schedules for your own User as well as any Users for which you are the Account Manager.

def get_schedules(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
page	`Optional` `DefaultValue`	Page offset to fetch.
per_page	`Optional` `DefaultValue`	Number of results to return per page.
user_id	`Optional`	Retrieve Schedules owned only by this User Id. You must be authorized to manage this User Id.

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

page = 1
collect['page'] = page

per_page = 10
collect['per_page'] = per_page

user_id = 45
collect['user_id'] = user_id


result = schedules.get_schedules(collect)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
404	Not Found
500	Unexpected error

Back to List of Controllers

ResourcesController

Get singleton instance

The singleton instance of the ResourcesController class can be accessed from the API Client.

resources = client.resources

delete_resource_by_id

Delete a Resource by id

def delete_resource_by_id(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
id	`Required`	TODO: Add a parameter description

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

id = 'id'
collect['id'] = id


result = resources.delete_resource_by_id(collect)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
404	Not Found
500	Unexpected error

update_resource_by_id

Update a Resource by id, with params

def update_resource_by_id(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
id	`Required`	TODO: Add a parameter description
update_resource_by_id_body	`Required`	the content of the request

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

id = 'id'
collect['id'] = id

update_resource_by_id_body = UpdateResourceByIdBody.new
collect['update_resource_by_id_body'] = update_resource_by_id_body


result = resources.update_resource_by_id(collect)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
404	Not Found
422	Unprocessable Entity
500	Unexpected error

get_resource_by_id

Return a Resource by id.

def get_resource_by_id(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
id	`Required`	TODO: Add a parameter description

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

id = 'id'
collect['id'] = id


result = resources.get_resource_by_id(collect)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
404	Not Found
500	Unexpected error

get_resource_things

Return all Resource Things.

def get_resource_things(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
page	`Optional` `DefaultValue`	Page offset to fetch.
per_page	`Optional` `DefaultValue`	Number of results to return per page.

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

page = 1
collect['page'] = page

per_page = 10
collect['per_page'] = per_page


result = resources.get_resource_things(collect)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
500	Unexpected error

create_resource

Create a Resource with params

def create_resource(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
create_resource_body	`Required`	the content of the request

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

create_resource_body = CreateResourceBody.new
collect['create_resource_body'] = create_resource_body


result = resources.create_resource(collect)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
422	Unprocessable Entity
500	Unexpected error

get_resources

Return list of Resources.

def get_resources(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
page	`Optional` `DefaultValue`	Page offset to fetch.
per_page	`Optional` `DefaultValue`	Number of results to return per page.
user_id	`Optional`	Retrieve Resources owned only by this User Id. You must be authorized to manage this User Id.

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

page = 1
collect['page'] = page

per_page = 10
collect['per_page'] = per_page

user_id = 45
collect['user_id'] = user_id


result = resources.get_resources(collect)

Errors

Error Code	Error Description
401	Unauthorized/Missing Token
403	Forbidden
404	Not Found
500	Unexpected error

Back to List of Controllers

PricingModelsController

Get singleton instance

The singleton instance of the PricingModelsController class can be accessed from the API Client.

pricingModels = client.pricing_models

update_pricing_model_by_id

Update a PricingModel by id, with params

def update_pricing_model_by_id(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
id	`Required`	TODO: Add a parameter description
update_pricing_model_by_id_body	`Required`	the content of the request

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

id = 'id'
collect['id'] = id

update_pricing_model_by_id_body = UpdatePricingModelByIdBody.new
collect['update_pricing_model_by_id_body'] = update_pricing_model_by_id_body


result = pricingModels.update_pricing_model_by_id(collect)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
404	Not Found
422	Unprocessable Entity
500	Unexpected error

get_pricing_model_by_id

Return a PricingModel by id.

def get_pricing_model_by_id(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
id	`Required`	TODO: Add a parameter description

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

id = 'id'
collect['id'] = id


result = pricingModels.get_pricing_model_by_id(collect)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
404	Not Found
500	Unexpected error

create_pricing_model

Create a PricingModel with params

def create_pricing_model(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
create_pricing_model_body	`Required`	the content of the request

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

create_pricing_model_body = CreatePricingModelBody.new
collect['create_pricing_model_body'] = create_pricing_model_body


result = pricingModels.create_pricing_model(collect)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
422	Unprocessable Entity
500	Unexpected error

get_pricing_models

Return list of PricingModels.

def get_pricing_models(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
page	`Optional` `DefaultValue`	Page offset to fetch.
per_page	`Optional` `DefaultValue`	Number of results to return per page.
user_id	`Optional`	Retrieve PricingModels owned only by this User Id. You must be authorized to manage this User Id.

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

page = 1
collect['page'] = page

per_page = 10
collect['per_page'] = per_page

user_id = 136
collect['user_id'] = user_id


result = pricingModels.get_pricing_models(collect)

Errors

Error Code	Error Description
401	Unauthorized/Missing Token
403	Forbidden
404	Not Found
500	Unexpected error

Back to List of Controllers

CategoriesController

Get singleton instance

The singleton instance of the CategoriesController class can be accessed from the API Client.

categories = client.categories

get_category_by_id

Return a Category by id.

def get_category_by_id(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
id	`Required`	TODO: Add a parameter description

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

id = 'id'
collect['id'] = id


result = categories.get_category_by_id(collect)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
404	Not Found
500	Unexpected error

create_category

Create a Category

def create_category(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
create_category_body	`Required`	the content of the request

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

create_category_body = CreateCategoryBody.new
collect['create_category_body'] = create_category_body


result = categories.create_category(collect)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
422	Unprocessable Entity
500	Unexpected error

get_categories

Return list of Categories.

def get_categories(options = Hash.new); end

Parameters

Parameter	Tags	Description
authorization	`Required`	A valid API key, in the format 'Token API_KEY'
page	`Optional` `DefaultValue`	Page offset to fetch.
per_page	`Optional` `DefaultValue`	Number of results to return per page.
user_id	`Optional`	Retrieve Categories of all services provided by this User Id. You must be authorized to manage this User Id.

Example Usage

collect = Hash.new

authorization = 'Authorization'
collect['authorization'] = authorization

page = 1
collect['page'] = page

per_page = 10
collect['per_page'] = per_page

user_id = 136
collect['user_id'] = user_id


result = categories.get_categories(collect)

Errors

Error Code	Error Description
400	Bad Request
401	Unauthorized/Missing Token
403	Forbidden
500	Unexpected error

Back to List of Controllers

Name		Name	Last commit message	Last commit date
Latest commit History 40 Commits
lib		lib
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
README.md		README.md
Rakefile		Rakefile
gonebusy-ruby-client.gemspec		gonebusy-ruby-client.gemspec

License

gonebusy/gonebusy-ruby-client

Folders and files

Latest commit

History

Repository files navigation

Getting started

Sandbox

How to Build

How to Use

API Key

Initialization/Authentication

How to Test

Class Reference

List of Controllers

BookingsController

Get singleton instance

create_booking

Parameters

Example Usage

Errors

get_bookings

Parameters

Example Usage

Errors

cancel_booking_by_id

Parameters

Example Usage

Errors

update_booking_by_id

Parameters

Example Usage

Errors

get_booking_by_id

Parameters

Example Usage

Errors

UsersController

Get singleton instance

update_user_by_id

Parameters

Example Usage

Errors

get_user_by_id

Parameters

Example Usage

Errors

get_users_pros

Parameters

Example Usage

Errors

create_user

Parameters

Example Usage

Errors

get_users

Parameters

Example Usage

Errors

ServicesController

Get singleton instance

delete_service_by_id

Parameters

Example Usage

Errors

update_service_by_id

Parameters

Example Usage

Errors

get_service_by_id

Parameters

Example Usage

Errors

create_service

Parameters

Example Usage

Errors

get_services

Parameters

Example Usage