Aptible::Api

Ruby client for api.aptible.com. Aptible's API server is built on top of HAL+JSON, and so this client is just a thin layer on top of the HyperResource gem.

Installation

Add the following lines to your application's Gemfile.

gem 'aptible-api'

And then run bundle install.

Usage

First, get a token:

token = Aptible::Auth::Token.create(email: '[email protected]', password: 'password')

From here, you can interact with the API however you wish:

accounts = Aptible::Api::Account.all(token: token)
account = accounts.first
account.handle
# => 'aptible'
account.apps.first.handle
# => "foodle"
newapp = account.create_app(handle: 'bardle')
newapp.href
# => "http://localhost:4001/apps/7"

Configuration

Parameter	Description	Default
`root_url`	Root URL of the API server	`ENV['APTIBLE_API_ROOT_URL']` or https://api.aptible.com

To point the client at a different API server (e.g., during development), add the following to your application's initializers (or set the APTIBLE_API_ROOT_URL environment variable):

Aptible::Api.configure do |config|
  config.root_url = 'http://some.other.url'
end

Contributing

Fork the project.
Commit your changes, with specs.
Ensure that your code passes specs (rake spec) and meets Aptible's Ruby style guide (rake rubocop).
Create a new pull request on GitHub.

Copyright and License

MIT License, see LICENSE for details.