A Ruby wrapper around the Apple Business Manager (ABM) and Apple School Manager (ASM) APIs. Collectively, they are AXM.

This gem is heavily inspired by Octokit and Oktakit. If you're familiar with those libraries, you should feel right at home.

Install the gem and add to the application's Gemfile by executing:

bundle add axm

If bundler is not being used to manage dependencies, install the gem by executing:

gem install axm

First, generate API credentials from the Apple Business Manager or Apple School Manager portal and store the credentials in a secure location accessible to your app.

With the credentials handy, you can create an instance of the client:

private_key = File.read('path/to/your/private_key.pem')
client_id = 'your_client_id'
key_id = 'your_key_id'

client = Axm::Client.new(private_key:, client_id:, key_id:)

You're now ready to make API requests.

client.list_org_devices

For any endpoints that don't currently exist in the gem, you can use the get or post method directly to make API requests

client.get('/v1/some/endpoint', { limit: 10 })

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

If the credentials are stored in the secrets/ directory, you can use the Axm::Secret.read method to load them:

private_key = Axm::Secret.read('private_key.pem')
client_id = Axm::Secret.read('client_id')
key_id = Axm::Secret.read('key_id')

client = Axm::Client.new(private_key:, client_id:, key_id:)

To install this gem onto your local machine, run bundle exec rake install.

1. Update the version number in lib/axm/version.rb
2. Add release notes to CHANGELOG.md
3. Run the "Release" Action

Bug reports and pull requests are welcome on GitHub at https://github.com/nick-f/axm. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.

The gem is available as open source under the terms of the MIT License.

Everyone interacting with the AXM codebase and issue tracker is expected to follow the code of conduct.