Foto zu URL Logo

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.

Produktbilder

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"
}