Quickstart

Quickstart

Fastest path to a working call. This uses a personal access token against your own account, so there is no OAuth flow to build yet. Do this first to prove the shape of things, then add OAuth when you want other designers to connect.

1. 1. Create a token

   Go to API & Developer settings, choose New token, and tick the scopes you need. It is shown once.

2. 2. Check who you are

   bash

   curl https://dustinsdesignerden.com/api/v1/me \
   -H "Authorization: Bearer YOUR_TOKEN"

   Returns your identity plus storage and project limits. Call this before an upload so you can tell the designer they are out of room instead of failing halfway.

3. 3. Create a project

   bash

   curl -X POST https://dustinsdesignerden.com/api/v1/projects \
   -H "Authorization: Bearer YOUR_TOKEN" \
   -H "Content-Type: application/json" \
   -d '{"name":"Harvest Moon"}'

4. 4. Add components

   bash

   curl -X POST https://dustinsdesignerden.com/api/v1/projects/PROJECT_ID/components/batch \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
   "type": "card",
   "components": [
     { "unique_id": "ext-1", "name": "Rusty Dagger", "quantity": 3,
       "image_url": "https://cdn.example.com/dagger.png",
       "deck_names": ["Weapons"] }
   ]
     }'

   That is the whole loop. Everything else is refinement.