STYLEPOT STUDIO API v1

The REST interface lets other systems (e.g. STYLEPOT ORDER) read your account and your image sets.

Authentication

Every request needs an API key from "My account" – as header "Authorization: Bearer <key>" or "X-Api-Key: <key>".

curl -H "Authorization: Bearer sps_…" https://studio.stylepot.de/api/v1/me

Errors are returned as JSON with an "error" field and a matching HTTP status (401 = key missing or invalid, 404 = not found).

GET /api/v1/me

Account and current balance.

{"id": 12, "email": "…", "name": "…", "company": "…", "balance_eur": 4.52}

GET /api/v1/sets?limit=50

The latest image sets with status.

{"sets": [{"id": 311, "name": "Gang Jeans grau", "created_at": "2026-09-26 10:12", "status": "done",
  "set": "classic", "model": "AMINA", "light": "studio", "charged_eur": 1.21,
  "images": [{"id": 902, "shot": "s01", "url": "https://…/m/…?e=…&s=…", "hd": false}],
  "videos": []}]}

GET /api/v1/sets/{id}

One image set with all images and download links (signed, time-limited).

Outlook

More endpoints (start an image set, article matching) will follow for the STYLEPOT ORDER integration.

Create API key