What is Dribbble?
Dribbble is show and tell for designers, developers and other creatives. Share sneak peeks of your work as “shots” – small screenshots of the designs and applications you’re working on.
The Dribbble API
The Dribbble API has been developed recently to allow developers access to the “shots” that people share. There are a small amount of methods available at the moment, with plans in the future for more advanced API methods such as login and publishing a “shot”.
StarDribbbleLib is an AS3 library, which was built using StarRequests, that allows developers to connect to the Dribbble API. If you’ve used StarRequests (or StarImageLib) before then you’ll already know how to use StarDribbbleLib. Each of the methods of the Dribbble API have been made available as modular requests.
Each request in the library implements the same interface, which is displayed below.
The started, progress and failed signals always dispatch the same payload. The started signal doesn’t dispatch a payload, the progress signal dispatches a Number (percentage) and the failed signal dispatches a String (the reason why it failed).
The only signal that changes its payload is the completed signal; this changes depending on the type of request you are making. For example, if you’re requesting shots (PopularShotsRequest) then the payload is of Shots type, whereas if you’re requesting a player (PlayerByIDRequest) then the payload is of Player type, likewise a shot request (ShotByIDRequest) will have a payload of type Shot.
Available API Methods
- DebutShotsRequest( page, amountPerPage )
- EveryoneShotsRequest( page, amountPerPage )
- FollowingShotsByPlayerIDRequest( playerID, page, amountPerPage )
- FollowingShotsByPlayerUsernameRequest( playerUsername, page, amountPerPage )
- PlayerByIDRequest( playerID )
- PlayerByUsernameRequest( playerUsername )
- PlayerShotsByIDRequest( playerID, page, amountPerPage )
- PlayerShotsByUsernameRequest( playerUsername, page, amountPerPage )
- PopularShotsRequest( page, amountPerPage )
- ShotByIDRequest( shotID )
Simply download the SWC from the downloads page and use it in your project.
The StarDribbbleLib is available on GitHub. Don’t forget you can fork the project and add issues.
The Dribbble API is in its first draft and therefore isn’t completely defined. This library works with the API in its current form and is no way affiliated with Dribbble. I have been providing feedback to the API developers to help improve the service and will continue to keep this library up to date. The information displayed above is correct at the time of writing.