API-Dokumentation
API-Zugang erfordert ein aktives Pro- oder Premium-Abo. Authentifizieren Sie sich mit einem API-Schlüssel und laden Sie Bilder in dieselbe Bibliothek wie im Dashboard. Kontingente entsprechen Ihrem bezahlten Web-Tarif.
Bild hochladen
POST /api/v1/upload mit multipart/form-data.
Parameter
Authorization- Pflicht. Request-Header. Format: Bearer IHR_API_SCHLÜSSEL.
file- Pflicht. Eine Binärdatei oder Base64-Daten.
name- Optional. Dateiname; bei lokalem Multipart-Upload wird er automatisch erkannt.
Beispielaufruf
Binärdatei
curl https://phototourl.com/api/v1/upload \ -X POST \ -H "Authorization: Bearer ptu_live_YOUR_KEY" \ -F "file=@./product.jpg"
Base64
curl https://phototourl.com/api/v1/upload \ -X POST \ -H "Authorization: Bearer ptu_live_YOUR_KEY" \ -F "file=R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7" \ -F "name=pixel.gif"
Lokale Dateien immer per POST hochladen. GET-Uploads werden nicht unterstützt.
Antwortfelder
id- Ressourcen-ID in Ihrer Bibliothek.
url- CDN-URL für Produktseiten.
fileName- Ursprünglicher Dateiname.
fileSize- Dateigröße in Bytes.
mimeType- MIME-Typ der hochgeladenen Datei.
createdAt- Upload-Zeit in UTC, Format YYYY-MM-DD HH:mm:ss.
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"url": "https://cdn.phototourl.com/pro/2026-11-05-a1b2c3d4-e5f6-7890-abcd-ef1234567890.jpg",
"fileName": "product.jpg",
"fileSize": 128472,
"mimeType": "image/jpeg",
"createdAt": "2026-11-05 10:20:30"
}Bilder auflisten
GET /api/v1/images mit optionalem page und pageSize (max. 100).
curl "https://phototourl.com/api/v1/images?page=1&pageSize=20" \ -H "Authorization: Bearer ptu_live_YOUR_KEY"
Antwortfelder
resources- Array der Bilder: id, fileName, url, fileSize, mimeType, createdAt.
page- Aktuelle Seitennummer.
pageSize- Einträge pro Seite.
total- Gesamtzahl der Bilder in der Bibliothek.
{
"resources": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"fileName": "product.jpg",
"url": "https://cdn.phototourl.com/pro/2026-11-05-a1b2c3d4-e5f6-7890-abcd-ef1234567890.jpg",
"fileSize": 128472,
"mimeType": "image/jpeg",
"createdAt": "2026-11-05 10:20:30"
}
],
"page": 1,
"pageSize": 20,
"total": 1
}Bild löschen
DELETE /api/v1/images/:id. Entfernt die Datei aus Speicher und Bibliothek.
curl -X DELETE https://phototourl.com/api/v1/images/RESOURCE_ID \ -H "Authorization: Bearer ptu_live_YOUR_KEY"
Antwortfelder
success- true, wenn das Bild gelöscht wurde.
{ "success": true }Limits
API ist im Free-Tarif nicht verfügbar. Pro und Premium nutzen die Upload-, Speicher- und Dateigrößenlimits Ihres Tarifs. Bei Überschreitung liefert die API einen Fehler mit upgradeUrl.
Fehler
Fehlgeschlagene Anfragen geben einen Fehlercode zurück. Kontingentfehler können upgradeUrl enthalten.
dailyLimitReached— Tages-Upload-Limit erreicht (HTTP 429).storageLimitReached— Speicherkontingent überschritten (HTTP 413).fileTooLarge— Datei größer als im Tarif erlaubt (HTTP 400).401— Fehlender, ungültiger oder widerrufener API-Schlüssel.
{
"error": "dailyLimitReached",
"errorParams": { "limit": 1000 },
"plan": "paid",
"limit": 1000,
"upgradeUrl": "https://www.phototourl.com/pricing"
}