Dribbble - Show and tell for designers
https://dribbble.com/oauth/authorize
Parameters:
client_id - The client ID you received from Dribbble when you registered.
redirect_uri - The URL in your application where users will be sent after authorization.
scope - A space separated list of scopes.
state - An unguessable random string. It is used to protect against cross-site request forgery attacks.
getAccessToken
block.Datatype | Description | Example |
---|---|---|
Datepicker | String which includes date and time | |
Map | String which includes latitude and longitude coma separated | |
List | Simple array | |
Select | String with predefined values | |
Array | Array of objects |
Returns access token.
Field | Type | Description |
---|---|---|
clientId | credentials | The client ID you received from Dribbble when you registered. |
clientSecret | credentials | The client secret you received from Dribbble when you registered. |
code | credentials | The OAuth verification code acquired via OAuth’s web authentication protocol. |
redirectUri | String | The URL in your application where users will be sent after authorization. |
Get a bucket.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Bucket id |
Creating a bucket requires the user to be authenticated with the write scope.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
name | String | The name of the bucket. |
description | String | A description of the bucket. |
Updating a bucket requires the user to be authenticated with the write scope. The authenticated user must also own the bucket.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Bucket id |
name | String | The name of the bucket. |
description | String | A description of the bucket. |
Deleting a bucket requires the user to be authenticated with the write scope. The authenticated user must also own the bucket.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Bucket id |
List shots for a bucket.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Bucket id |
Adding a shot to a bucket requires the user to be authenticated with the write scope. The authenticated user must also own the bucket.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Bucket id |
shotId | Number | The ID of the shot to add. |
Removing a shot to a bucket requires the user to be authenticated with the write scope. The authenticated user must also own the bucket.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Bucket id |
shotId | Number | The ID of the shot to remove. |
Get a project.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Project id |
List shots for a project.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Project id |
List shots.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
list | Select | Limit the results to a specific type with the following possible values: animated, attachments, debuts, playoffs, rebounds, teams |
timeframe | Select | A period of time to limit the results to with the following possible values: week, month, year, ever |
date | DatePicker | Limit the timeframe to a specific date, week, month, or year. |
sort | Select | The sort field with the following possible values: comments, recent, views |
Get a shot.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Shot id |
Creating a shot requires the user to be authenticated with the upload scope. The authenticated user must also be a player or team.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
title | String | The title of the shot. |
image | File | The image file. It must be exactly 400x300 or 800x600, no larger than eight megabytes, and be a GIF, JPG, or PNG. |
description | String | A description of the shot. |
tags | List | Tags for the shot. |
teamId | String | An ID of a team to associate the shot with. The authenticated user must either be a member of the team or be authenticated as the same team. |
reboundSourceId | Number | An ID of a shot that the new shot is a rebound of. The shot must be reboundable and by a user not blocking the authenticated user. |
lowProfile | Boolean | Specify true if the shot is Low Profile. |
Updating a shot requires the user to be authenticated with the upload scope. The authenticated user must also own the shot.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Shot id |
title | String | The title of the shot. |
image | File | The image file. It must be exactly 400x300 or 800x600, no larger than eight megabytes, and be a GIF, JPG, or PNG. |
description | String | A description of the shot. |
tags | List | Tags for the shot. |
teamId | String | An ID of a team to associate the shot with. The authenticated user must either be a member of the team or be authenticated as the same team. |
reboundSourceId | Number | An ID of a shot that the new shot is a rebound of. The shot must be reboundable and by a user not blocking the authenticated user. |
lowProfile | Boolean | Specify true if the shot is Low Profile. |
Deleting a shot requires the user to be authenticated with the upload scope. The authenticated user must also own the shot.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Shot id |
List attachments for a shot.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Shot id |
Creating an attachment requires the user to be authenticated with the upload scope. The authenticated user must own the shot and be a pro, a team, or a member of a team.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Shot id |
file | File | The attachment file. It must be no larger than 10 megabytes. |
Get a single attachment.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Shot id |
attachmentId | String | Attachment id |
Deleting an attachment requires the user to be authenticated with the upload scope. The authenticated user must also own the attachment.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Shot id |
attachmentId | String | Attachment id |
List buckets for a shot.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Shot id |
List comments for a shot.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Shot id |
List likes for a comment.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Shot id |
commentId | String | Comment id |
Creating a comment requires the user to be authenticated with the comment scope. The authenticated user must also be a player or team.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Shot id |
body | String | The contents of the comment. |
Get a single comment.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Shot id |
commentId | String | Comment id |
Updating a comment requires the user to be authenticated with the comment scope. The authenticated user must also own the comment.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Shot id |
commentId | String | Comment id |
body | String | The contents of the comment. |
Deleting a comment requires the user to be authenticated with the comment scope. The authenticated user must also own the comment.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Shot id |
commentId | String | Comment id |
Checking for a comment like requires the user to be authenticated.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Shot id |
commentId | String | Comment id |
Liking a comment requires the user to be authenticated with the write scope.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Shot id |
commentId | String | Comment id |
Unliking a comment requires the user to be authenticated with the write scope.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Shot id |
commentId | String | Comment id |
List the likes for a shot.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Shot id |
Checking for a shot like requires the user to be authenticated.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Shot id |
Liking a shot requires the user to be authenticated with the write scope.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Shot id |
Unliking a shot requires the user to be authenticated with the write scope.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Shot id |
List projects for a shot.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Shot id |
List rebounds for a shot.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Shot id |
List a team’s members.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Team id |
List shots by the team and team members.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | Team id |
Get a single user.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | User id |
List a user’s buckets.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | User id |
List a user’s followers.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | User id |
List who a user is following.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | User id |
Listing shots from followed users requires the user to be authenticated with the public scope. Also note that you can not retrieve more than 600 results, regardless of the number requested per page.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
Check if you are following a user.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | User id |
Check if one user is following another.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | User id |
targetUser | String | User id |
Following a user requires the user to be authenticated with the write scope.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | User id |
Unfollowing a user requires the user to be authenticated with the write scope.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | User id |
List shot likes for a user.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | User id |
List a user’s projects.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | User id |
List a user’s shots.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | User id |
List a user’s teams.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
id | String | User id |
Create a job.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
organizationName | String | The name of the organization the position is with. |
title | String | The title of the job position. |
location | String | The physical location of the position (e.g. “Boston” or “Anywhere”). |
url | String | An absolute URL to the full details of the job listing. |
active | String | true if you want the job to be published immediately. |
team | String | The integer id or string login of the team that you want associated with the job. |
Update a job.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
jobId | String | Id of the updated job. |
organizationName | String | The name of the organization the position is with. |
title | String | The title of the job position. |
location | String | The physical location of the position (e.g. “Boston” or “Anywhere”). |
url | String | An absolute URL to the full details of the job listing. |
active | String | true if you want the job to be published immediately. |
team | String | The integer id or string login of the team that you want associated with the job. |
Show a job.
Field | Type | Description |
---|---|---|
accessToken | credentials | You dribbble access token |
jobId | String | Id of the updated job. |