dribbblejs

A promise based, Typescript-first Dribbble API library.

Features

🤖 Full Typescript support

🌈 Familiar API setup

⚡️ Feather light

🚨 Proper error handling

🧘‍♀️ Framework agnostic

Getting Started

Installation

with Yarn

$ yarn add dribbblejs

or with NPM

$ npm install dribbblejs

Usage

import { Dribbble } from "dribbblejs";

const dribbble = new Dribbble({
  authToken: "xxxxxxxx"
});

API

User

Official User API Documentation

Get authenticated user

dribbble.user.get()

---

Projects

Official Projects API Documentation

Get list of projects

dribbble.projects.list()

Create a project

dribbble.projects.create({
    name: 'Project name', // *Required*
    description: 'Project description' // Optional
})

Update a project by id

dribbble.projects.update('883377', {
    name: 'New project name', // Optional
    description: 'New project description' // Optional
})

Delete a project by id

dribbble.projects.delete('883377')

---

Shots

Official Shots API Documentation

Get list of shots

dribbble.shots.list()

Get a shot by id

dribbble.shots.get('6432565')

Create a shot

dribbble.shots.create({
    image: imageFile // *Required*
    title: 'Shot title', // *Required*
    description: 'Shot description', // Optional
    low_profile: true, // Optional
    rebound_source_id: 6432542, // Optional
    scheduled_for: 1582391638790, // Optional
    tags: ['ui', 'illustration'], // Optional
    team_id: 3818924 // Optional
})

Update a shot by id

dribbble.shots.update('6432565', {
    title: 'New shot title', // Optional
    description: 'New shot description', // Optional
    low_profile: true, // Optional
    rebound_source_id: 6432542, // Optional
    scheduled_for: 1582391638790, // Optional
    tags: ['ui', 'illustration'], // Optional
    team_id: 3818924 // Optional
})

Delete a shot by id

dribbble.shots.delete('6432565')

---

Attachments API

Official Attachments API Documentation

Create attachment for a shot

dribbble.attachments.create('6432565', {
    file: attachmentFile // *Required*
})

Delete attachment id for a shot

dribbble.attachments.delete('1376676', '6432565')

---

License

Dribbblejs is MIT licensed.

Changelog

Version 0.0.19 (2020-3-7)

New features

• Replace whatwg-fetch with fetch-ponyfill: eddbb76
• Update jest types: e059a95

Bug fixes

• Update typescript 3.4.5 -> 3.8.2: a973baa
• Update husky 2.2.0 -> 4.2.3: d3d4ddb
• Update lint-staged 8.1.6 -> 10.0.7: c02e9e9
• Update rollup 1.11.3 -> 1.31.1: a54e4e6
• Update rollup dependencies: plugin-babel 4.3.2 -> 4.3.3 plugin-peer-deps-external 2.2.0 ->2.2.2 plugin-typescript2 0.21.0 -> 0.26.0: 820a261

...full changes