Developer

Comments

List comments for a shot

GET /shots/:shot/comments

Response

Status: 200 OK
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
[
  {
    "id" : 1145736,
    "body" : "<p>Could he somehow make the shape of an \"S\" with his arms? I feel like i see potential for some hidden shapes in here...</p>\n\n<p>Looks fun!\n</p>",
    "likes_count" : 1,
    "likes_url" : "https://api.dribbble.com/v1/shots/471756/comments/1145736/likes",
    "created_at" : "2012-03-15T04:24:39Z",
    "updated_at" : "2012-03-15T04:24:39Z",
    "user" : {
      "id" : 1,
      "name" : "Dan Cederholm",
      "username" : "simplebits",
      "html_url" : "https://dribbble.com/simplebits",
      "avatar_url" : "https://d13yacurqjgara.cloudfront.net/users/1/avatars/normal/dc.jpg?1371679243",
      "bio" : "Co-founder &amp; designer of <a href=\"https://dribbble.com/dribbble\">@Dribbble</a>. Principal of SimpleBits. Aspiring clawhammer banjoist.",
      "location" : "Salem, MA",
      "links" : {
        "web" : "http://simplebits.com",
        "twitter" : "https://twitter.com/simplebits"
      },
      "buckets_count" : 10,
      "comments_received_count" : 3395,
      "followers_count" : 29262,
      "followings_count" : 1728,
      "likes_count" : 34954,
      "likes_received_count" : 27568,
      "projects_count" : 8,
      "rebounds_received_count" : 504,
      "shots_count" : 214,
      "teams_count" : 1,
      "can_upload_shot" : true,
      "type" : "Player",
      "pro" : true,
      "buckets_url" : "https://dribbble.com/v1/users/1/buckets",
      "followers_url" : "https://dribbble.com/v1/users/1/followers",
      "following_url" : "https://dribbble.com/v1/users/1/following",
      "likes_url" : "https://dribbble.com/v1/users/1/likes",
      "shots_url" : "https://dribbble.com/v1/users/1/shots",
      "teams_url" : "https://dribbble.com/v1/users/1/teams",
      "created_at" : "2009-07-08T02:51:22Z",
      "updated_at" : "2014-02-22T17:10:33Z"
    }
  }
]

List likes for a comment

GET /shots/:shot/comments/:id/likes

Response

Status: 200 OK
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
[
  {
    "id" : 24400091,
    "created_at" : "2014-01-06T17:19:59Z",
    "user" : {
      "id" : 1,
      "name" : "Dan Cederholm",
      "username" : "simplebits",
      "html_url" : "https://dribbble.com/simplebits",
      "avatar_url" : "https://d13yacurqjgara.cloudfront.net/users/1/avatars/normal/dc.jpg?1371679243",
      "bio" : "Co-founder &amp; designer of <a href=\"https://dribbble.com/dribbble\">@Dribbble</a>. Principal of SimpleBits. Aspiring clawhammer banjoist.",
      "location" : "Salem, MA",
      "links" : {
        "web" : "http://simplebits.com",
        "twitter" : "https://twitter.com/simplebits"
      },
      "buckets_count" : 10,
      "comments_received_count" : 3395,
      "followers_count" : 29262,
      "followings_count" : 1728,
      "likes_count" : 34954,
      "likes_received_count" : 27568,
      "projects_count" : 8,
      "rebounds_received_count" : 504,
      "shots_count" : 214,
      "teams_count" : 1,
      "can_upload_shot" : true,
      "type" : "Player",
      "pro" : true,
      "buckets_url" : "https://dribbble.com/v1/users/1/buckets",
      "followers_url" : "https://dribbble.com/v1/users/1/followers",
      "following_url" : "https://dribbble.com/v1/users/1/following",
      "likes_url" : "https://dribbble.com/v1/users/1/likes",
      "shots_url" : "https://dribbble.com/v1/users/1/shots",
      "teams_url" : "https://dribbble.com/v1/users/1/teams",
      "created_at" : "2009-07-08T02:51:22Z",
      "updated_at" : "2014-02-22T17:10:33Z"
    }
  }
]

Create a comment

POST /shots/:shot/comments

Creating a comment requires the user to be authenticated with the comment scope. The authenticated user must also be a player or team.

Any username mentions, such as @simplebits, are automatically parsed and linked.

Parameters

Name Type Description
body string Required. The contents of the comment.

Example

{
  "body" : "<p>Could he somehow make the shape of an \"S\" with his arms? I feel like i see potential for some hidden shapes in here...</p>\n\n<p>Looks fun!\n</p>"
}

Response

Status: 201 Created
Location: https://api.dribbble.com/v1/shots/471756/comments/3360155
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
{
  "id" : 1145736,
  "body" : "<p>Could he somehow make the shape of an \"S\" with his arms? I feel like i see potential for some hidden shapes in here...</p>\n\n<p>Looks fun!\n</p>",
  "likes_count" : 1,
  "likes_url" : "https://api.dribbble.com/v1/shots/471756/comments/1145736/likes",
  "created_at" : "2012-03-15T04:24:39Z",
  "updated_at" : "2012-03-15T04:24:39Z",
  "user" : {
    "id" : 1,
    "name" : "Dan Cederholm",
    "username" : "simplebits",
    "html_url" : "https://dribbble.com/simplebits",
    "avatar_url" : "https://d13yacurqjgara.cloudfront.net/users/1/avatars/normal/dc.jpg?1371679243",
    "bio" : "Co-founder &amp; designer of <a href=\"https://dribbble.com/dribbble\">@Dribbble</a>. Principal of SimpleBits. Aspiring clawhammer banjoist.",
    "location" : "Salem, MA",
    "links" : {
      "web" : "http://simplebits.com",
      "twitter" : "https://twitter.com/simplebits"
    },
    "buckets_count" : 10,
    "comments_received_count" : 3395,
    "followers_count" : 29262,
    "followings_count" : 1728,
    "likes_count" : 34954,
    "likes_received_count" : 27568,
    "projects_count" : 8,
    "rebounds_received_count" : 504,
    "shots_count" : 214,
    "teams_count" : 1,
    "can_upload_shot" : true,
    "type" : "Player",
    "pro" : true,
    "buckets_url" : "https://dribbble.com/v1/users/1/buckets",
    "followers_url" : "https://dribbble.com/v1/users/1/followers",
    "following_url" : "https://dribbble.com/v1/users/1/following",
    "likes_url" : "https://dribbble.com/v1/users/1/likes",
    "shots_url" : "https://dribbble.com/v1/users/1/shots",
    "teams_url" : "https://dribbble.com/v1/users/1/teams",
    "created_at" : "2009-07-08T02:51:22Z",
    "updated_at" : "2014-02-22T17:10:33Z"
  }
}

Get a single comment

GET /shots/:shot/comments/:id

Response

Status: 200 OK
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
{
  "id" : 1145736,
  "body" : "<p>Could he somehow make the shape of an \"S\" with his arms? I feel like i see potential for some hidden shapes in here...</p>\n\n<p>Looks fun!\n</p>",
  "likes_count" : 1,
  "likes_url" : "https://api.dribbble.com/v1/shots/471756/comments/1145736/likes",
  "created_at" : "2012-03-15T04:24:39Z",
  "updated_at" : "2012-03-15T04:24:39Z",
  "user" : {
    "id" : 1,
    "name" : "Dan Cederholm",
    "username" : "simplebits",
    "html_url" : "https://dribbble.com/simplebits",
    "avatar_url" : "https://d13yacurqjgara.cloudfront.net/users/1/avatars/normal/dc.jpg?1371679243",
    "bio" : "Co-founder &amp; designer of <a href=\"https://dribbble.com/dribbble\">@Dribbble</a>. Principal of SimpleBits. Aspiring clawhammer banjoist.",
    "location" : "Salem, MA",
    "links" : {
      "web" : "http://simplebits.com",
      "twitter" : "https://twitter.com/simplebits"
    },
    "buckets_count" : 10,
    "comments_received_count" : 3395,
    "followers_count" : 29262,
    "followings_count" : 1728,
    "likes_count" : 34954,
    "likes_received_count" : 27568,
    "projects_count" : 8,
    "rebounds_received_count" : 504,
    "shots_count" : 214,
    "teams_count" : 1,
    "can_upload_shot" : true,
    "type" : "Player",
    "pro" : true,
    "buckets_url" : "https://dribbble.com/v1/users/1/buckets",
    "followers_url" : "https://dribbble.com/v1/users/1/followers",
    "following_url" : "https://dribbble.com/v1/users/1/following",
    "likes_url" : "https://dribbble.com/v1/users/1/likes",
    "shots_url" : "https://dribbble.com/v1/users/1/shots",
    "teams_url" : "https://dribbble.com/v1/users/1/teams",
    "created_at" : "2009-07-08T02:51:22Z",
    "updated_at" : "2014-02-22T17:10:33Z"
  }
}

Update a comment

PUT /shots/:shot/comments/:id

Updating a comment requires the user to be authenticated with the comment scope. The authenticated user must also own the comment.

Response

Status: 200 OK
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
{
  "id" : 1145736,
  "body" : "<p>Could he somehow make the shape of an \"S\" with his arms? I feel like i see potential for some hidden shapes in here...</p>\n\n<p>Looks fun!\n</p>",
  "likes_count" : 1,
  "likes_url" : "https://api.dribbble.com/v1/shots/471756/comments/1145736/likes",
  "created_at" : "2012-03-15T04:24:39Z",
  "updated_at" : "2012-03-15T04:24:39Z",
  "user" : {
    "id" : 1,
    "name" : "Dan Cederholm",
    "username" : "simplebits",
    "html_url" : "https://dribbble.com/simplebits",
    "avatar_url" : "https://d13yacurqjgara.cloudfront.net/users/1/avatars/normal/dc.jpg?1371679243",
    "bio" : "Co-founder &amp; designer of <a href=\"https://dribbble.com/dribbble\">@Dribbble</a>. Principal of SimpleBits. Aspiring clawhammer banjoist.",
    "location" : "Salem, MA",
    "links" : {
      "web" : "http://simplebits.com",
      "twitter" : "https://twitter.com/simplebits"
    },
    "buckets_count" : 10,
    "comments_received_count" : 3395,
    "followers_count" : 29262,
    "followings_count" : 1728,
    "likes_count" : 34954,
    "likes_received_count" : 27568,
    "projects_count" : 8,
    "rebounds_received_count" : 504,
    "shots_count" : 214,
    "teams_count" : 1,
    "can_upload_shot" : true,
    "type" : "Player",
    "pro" : true,
    "buckets_url" : "https://dribbble.com/v1/users/1/buckets",
    "followers_url" : "https://dribbble.com/v1/users/1/followers",
    "following_url" : "https://dribbble.com/v1/users/1/following",
    "likes_url" : "https://dribbble.com/v1/users/1/likes",
    "shots_url" : "https://dribbble.com/v1/users/1/shots",
    "teams_url" : "https://dribbble.com/v1/users/1/teams",
    "created_at" : "2009-07-08T02:51:22Z",
    "updated_at" : "2014-02-22T17:10:33Z"
  }
}

Delete a comment

DELETE /shots/:shot/comments/:id

Deleting a comment requires the user to be authenticated with the comment scope. The authenticated user must also own the comment.

Response

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

Check if you like a comment

GET /shots/:shot/comments/:id/like

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

Response, if the user likes the comment

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 comment

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

Like a comment

POST /shots/:shot/comments/:id/like

Liking a comment 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 comment

DELETE /shots/:shot/comments/:id/like

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

Response

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