STYLEPOT STUDIO API v1

Die REST-Schnittstelle erlaubt anderen Systemen (z. B. STYLEPOT ORDER) den lesenden Zugriff auf dein Konto und deine Bildsets.

Authentifizierung

Jede Anfrage braucht einen API-Schlüssel aus „Mein Konto“ – als Header „Authorization: Bearer <Schlüssel>“ oder „X-Api-Key: <Schlüssel>“.

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

Fehler werden als JSON mit Feld „error“ und passendem HTTP-Status geliefert (401 = Schlüssel fehlt oder ungültig, 404 = nicht gefunden).

GET /api/v1/me

Konto und aktuelles Guthaben.

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

GET /api/v1/sets?limit=50

Die letzten Bildsets mit 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}

Ein Bildset mit allen Bildern und Download-Links (zeitlich begrenzt signiert).

Ausblick

Weitere Endpunkte (Bildset starten, Artikel-Zuordnung) folgen für die Anbindung an STYLEPOT ORDER.

API-Schlüssel anlegen