Checkie API

Service

The host for the server API is checki.es

/:longKey

Redirects to a venue on Foursquare. longKey is a Foursquare venue identifier. Foursquare's venue identifiers are 24 character hex numbers. For example checki.es/42853f80f964a5200c231fe3 redirects to foursquare.com/v/42853f80f964a5200c231fe3.

/:shortKey

Redirects to a venue on Foursquare. shortKey is a base 64 encoded Foursquare venue identifier with the character / replaced with _. Foursquare's venue identifiers are 24 character hex numbers, which compact nicely to 16 digit base 64. For example the code in checki.es/QoU_gPlkpSAMIx_j becomes 42853f80f964a5200c231fe3, that call redirects to foursquare.com/v/42853f80f964a5200c231fe3.

/twitter_card/venue/:longKey

Returns Twitter card meta tags for a given checki.es venue link. The twitterbot user agent is redirected to these pages for venue links.

/l:longKey

Redirects to a list on Foursquare. longKey is a Foursquare list identifier. Foursquare's list identifiers are 24 character hex numbers. For example checki.es/l5461b8a0498e876833f73ee2 redirects to https://foursquare.com/list/5461b8a0498e876833f73ee2.

/l:shortKey

Redirects to a Foursquare list. shortKey is a base 64 encoded Foursquare list identifier with the character / replaced with _. For example checki.es/lVGG4oEmOh2gz9z7i.

/twitter_card/list/:longKey

Returns Twitter card meta tags for a given checki.es list link. The twitterbot user agent is redirected to these pages for list links.

/shorten/:longKey

longKey is a base 16 number to be encoded. The result is simply the base 64 encoded version of the same number with the character / replaced _. This should be done client side as it doesn't require hitting the network, but is included for testing. For example checki.es/shorten/42853f80f964a5200c231fe3 returns QoU_gPlkpSAMIx_j.

Client

The scheme for the iOS app is checkie://

/checkin?id=:id&private=:private

Checks the user in to a venue.