Build on PixelCore

1. Upload an image

Three steps: ask the API for a presigned URL, PUT bytes directly to R2, finalize the metadata.

# Step 1 - get a presigned URL
INIT=$(curl -X POST https://api.pixelcore.com/v1/upload/init \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fileName": "cat.jpg",
    "contentType": "image/jpeg",
    "size": 248192,
    "isPublic": true,
    "tags": ["pets", "cute"]
  }')
CODE=$(echo "$INIT" | jq -r .code)
URL=$(echo "$INIT" | jq -r .uploadUrl)

# Step 2 - upload the bytes (browser does this automatically; here for scripts)
curl -X PUT "$URL" --data-binary @cat.jpg -H "Content-Type: image/jpeg"

# Step 3 - finalize
curl -X POST https://api.pixelcore.com/v1/upload/finalize \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"code\":\"$CODE\"}"

# Share at https://pixelcore.com/p/$CODE

2. Subscribe to live scoreboard updates

WebSocket fires scoreUpdate every time a player anywhere on Earth finishes today's puzzle.

const ws = new WebSocket('wss://api.pixelcore.com/v1/games/scoreboard/ws?game=lettercore');
ws.onmessage = (e) => {
  const evt = JSON.parse(e.data);
  console.log(evt.displayName, 'finished in', evt.score, 'guesses');
};

3. Download from any URL via yt-dlp bridge

POST /v1/download/init
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "audioOnly": false,
  "isPublic": false
}

# Response: { "code": "abc1234", "status": "pending", "shareUrl": "..." }
# Poll /v1/download/jobs/abc1234 until status === 'done'