Project

rebrandly

0.01
No commit activity in last 3 years
No release in over 3 years
Easily use Rebrandly's HTTP API using this gem.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.13
~> 10.0
~> 3.0

Runtime

~> 0.14
 Project Readme

Rebrandly

This is very much a work in progress. I've created this so I could use Ruby to shorten URL's with Rebrandly. I hope to continue to work on this gem in the near future to do testing, error checking, etc. This is a very early version.

Installation

Add this line to your application's Gemfile:

gem 'rebrandly'

And then execute:

$ bundle

Or install it yourself as:

$ gem install rebrandly

Usage

If using Rails, put the following into your application.rb. If just Ruby, run this before trying to use the API.

Rebrandly.configure do |config|
  config.api_key = 'YOUR_KEY_HERE'
end

Instantiate an API object.

api = Rebrandly::Api.new

API Requests

api.links                           # GET /v1/links
api.link(id)                        # GET /v1/links/:id
api.link_count(options)             # GET /v1/links/count
api.new_link(options)               # GET /v1/links/new
api.shorten(destination, options)   # POST /v1/links
api.update_link(id, options)        # POST /v1/links/:id
api.delete(id, options)             # DELETE /v1/links/:id
api.domains                         # GET /v1/domains
api.domain(id)                      # GET /v1/domains/:id
api.domain_count(options)           # GET /v1/domains/count
api.account                         # GET /v1/account

Make a new short link

my_domain = api.domains.first
link = api.shorten('https://google.com', domain: my_domain.to_h, title: 'Google', description: 'The Googles!!!', favourite: true)

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/ardavis/rebrandly.

License

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