Developer

You're looking at the new v2 API docs. If you're maintaining an existing v1 API app, you may want to see the v1 docs instead.

Likes

List likes

List the authenticated user’s liked shots. Note: This is available only to select applications with our approval.

GET /user/likes

Response

Status: 200 OK
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
[
  {
    "id" : 305931,
    "created_at" : "2016-01-11T18:23:31Z",
    "shot" : {
      "id" : 471756,
      "title" : "Sasquatch",
      "description" : "<p>Quick, messy, five minute sketch of something that might become a fictional something.</p>",
      "images" : {
        "hidpi" : null,
        "normal" : "https://d13yacurqjgara.cloudfront.net/users/1/screenshots/471756/sasquatch.png",
        "teaser" : "https://d13yacurqjgara.cloudfront.net/users/1/screenshots/471756/sasquatch_teaser.png"
      },
      "published_at" : "2012-03-15T01:52:33Z",
      "html_url" : "https://dribbble.com/shots/471756-Sasquatch",
      "height" : 300,
      "width" : 400
    },
    "user" : {
      "id" : 1,
      "name" : "Dan Cederholm",
      "login" : "simplebits",
      "html_url" : "https://dribbble.com/simplebits"
    }
  }
]

Shots - Likes

Check if you like a shot

Note: This is available only to select applications with our approval.

GET /shots/:id/like

Checking for a shot like requires the user to be authenticated.

Response, if the user likes the shot

Status: 200 OK
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
{
  "id" : 24400091,
  "created_at" : "2014-01-06T17:19:59Z"
}

Response, if the user does not like the shot

Status: 404 Not Found
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59

Like a shot

Note: This is available only to select applications with our approval.

POST /shots/:id/like

Liking a shot requires the user to be authenticated with the write scope.

Response

Status: 201 Created
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
{
  "id" : 24400091,
  "created_at" : "2014-01-06T17:19:59Z"
}

Unlike a shot

Note: This is available only to select applications with our approval.

DELETE /shots/:id/like

Unliking a shot requires the user to be authenticated with the write scope.

Response

Status: 204 No Content
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59