FORGEBOX Enterprise 🚀 - Take your ColdFusion (CFML) Development to Modern Times! Learn More...

Bitly SDK

v1.0.0 Public

This SDK allows you to add URL shortening and expanding to your ColdFusion (CFML) applications. You will need an API key in order to use this model. For more information visit:


This SDK can be installed as standalone or as a ColdBox Module. Either approach requires a simple CommandBox command:

box install cfbitly

Then follow either the standalone or module instructions below.


This SDK will be installed into a directory called cfbitly and then the SDK can be instantiated via new cfbitly.Bitly() with the following constructor arguments:

* Constructor
* @APIVersion The API version to use. Defaults to 2.0.1
* @APILogin The API login to use
* @APIKey The API key to connect with
function init( APIVersion="2.0.1", required APILogin, required APIKey ){

ColdBox Module

This package also is a ColdBox module as well. The module can be configured by creating an bitly configuration structure in your application configuration file: config/Coldbox.cfc with the following settings:

// Bitly Settings
bitly = {
	// The version of the api to use, defaults to 2.0.1
	APIVersion = "2.0.1",  
	// The login to use
	APILogin = "",
	// The API Key to use
	APIKey = ""

Then you can leverage the SDK CFC via the injection DSL: [email protected]


Here are the functions you can use with this SDK

function shorten( required inURL )
function expand( required inURL, required inUserHash )

Here are all the versions for this package. Please note that you can leverage CommandBox package versioning to install any package you like. Please refer to our managing package version guide for more information.

Version Created Last Update Published By Stable Actions
1.0.0 Jul 27 2016 08:19 AM Jul 27 2016 08:19 AM


No collaborators yet.
  • Jul 27 2016 08:19 AM
  • Jul 27 2016 08:19 AM
  • 776
  • 648
  • 7