What can I access?
There are only three objects:
Users, Channels and Broadcasts
  • Users: are people like you and me. These will be the people using your application.
  • Broadcasts: are web videos that have been shared (twitter, facebook, tumblr, email). Every broadcast is unique as every broadcast was shared in a different way
  • Channels: contain Broadcasts, and are owned by users.
How do I do it?

We've got the english explanation below. Be sure to give that a quick persual. But if English is your second language and code is your first, we've got you covered...

Authentication (oAuth 1.0a)
Ah, yes. Authentication. The least fun part of working with an API. We've tried to make it quick and painless. Follow these steps:
  1. Create an application here. You'll need to sign in to your Shelby account. The process will provide you with OAuth credentials.
  2. Authenticate users to your application following the vanilla oAuth 1.0a 'three legged' approach. Our auth URLs are as follows:

    All requests against these URLs must use the HMAC-SHA1 signature method

    http://dev.shelby.tv/oauth/request_token
    http://dev.shelby.tv/oauth/authorize
    http://dev.shelby.tv/oauth/access_token

  3. You'll have to sign data requests according to the oAuth plaintext 'two-legged' approach. Generally speaking, if you're trying to access resources belonging to Bob, you'll need to sign the request with Bob's oAuth tokens
  4. Check out the standard oAuth libraries for ruby, node, python, clojure and php
  5. Finally, if you use the omniauth ruby gem, we have included Shelby auth as a built in strategy (for your convenience).
All requests made to the URLs below must be signed using the HMAC-SHA1 method.
Users
Get the authed user
api.shelby.tv/v2/users.json
Channels
Get the authed user's channels
api.shelby.tv/v2/channels.json
Get the channel with channel_id :id
api.shelby.tv/v2/channels/:id.json
Broadcasts
Get the broadcast with broadcast_id :id
api.shelby.tv/v2/broadcasts/:id.json
Get all broadcasts belonging to the channel with channel_id :id
api.shelby.tv/v2/channels/:id/broadcasts.json
Special Query Params
These can be included after a '?' on any query.
'limit' (integer) return a subset of results
'skip' (integer) ignore the first n results
'sort' (string) specify a sort preference ['asc' or 'desc']
'fields' (comma delimited string) return only the specified fields