Gem Version

A simple gem to wrap the Codelocks NetCode API, for generating key codes to operate their physical locks.

API Versions

If you are using an API version prior to v4.1, you need to use the latest v1 release of this gem. v2 is a large rewrite in order to support the new API.


Add this line to your application's Gemfile:

gem 'codelocks'

And then execute:

$ bundle

Or install it yourself as:

$ gem install codelocks


Configure your API credentials, either by setting the following two environment variables:


Or by setting them directly in Ruby:

Codelocks.base_uri = ""
Codelocks.api_key = "blargh"
Codelocks.access_key = "argh"

API documentation with information on methods is available on


The test suite can be run locally using the following commands:

$ cp .env.test .env
$ dotenv
$ bundle exec rspec


  1. Fork it ([my-github-username]/codelocks/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request