Logo Zdjęcie do URL

Dokumentacja API

Dostęp do API wymaga aktywnej subskrypcji Pro lub Premium. Uwierzytelnij się kluczem API, a potem przesyłaj obrazy do tej samej biblioteki co w Panelu. Limity jak w planie płatnym na stronie.

Zdjęcia produktów

Prześlij obraz

POST /api/v1/upload z multipart/form-data.

Parametry

Authorization
Wymagane. Nagłówek żądania. Format: Bearer TWOJ_KLUCZ_API.
file
Wymagane. Plik binarny lub dane base64.
name
Opcjonalne. Nazwa pliku; przy lokalnym uploadzie multipart wykrywana automatycznie.

Przykładowe wywołanie

Plik binarny

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"

Lokalne pliki zawsze wysyłaj metodą POST. Upload przez GET nie jest obsługiwany.

Pola odpowiedzi

id
Id zasobu w Twojej bibliotece.
url
URL CDN do użycia na stronach produktów.
fileName
Oryginalna nazwa pliku.
fileSize
Rozmiar pliku w bajtach.
mimeType
Typ MIME przesłanego pliku.
createdAt
Czas przesłania w 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"
}

Lista obrazów

GET /api/v1/images z opcjonalnymi page i pageSize (maks. 100).

curl "https://phototourl.com/api/v1/images?page=1&pageSize=20" \
  -H "Authorization: Bearer ptu_live_YOUR_KEY"

Pola odpowiedzi

resources
Tablica obrazów: id, fileName, url, fileSize, mimeType, createdAt.
page
Numer bieżącej strony.
pageSize
Elementów na stronę.
total
Łączna liczba obrazów w bibliotece.
{
  "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
}

Usuń obraz

DELETE /api/v1/images/:id. Usuwa plik z magazynu i Twojej biblioteki.

curl -X DELETE https://phototourl.com/api/v1/images/RESOURCE_ID \
  -H "Authorization: Bearer ptu_live_YOUR_KEY"

Pola odpowiedzi

success
true, gdy obraz został usunięty.
{ "success": true }

Limity

API niedostępne na Free. Pro i Premium używają limitów przesyłania, magazynu i rozmiaru pliku z planu. Po przekroczeniu API zwraca błąd z upgradeUrl.

Błędy

Nieudane żądania zwracają kod błędu. Błędy limitów mogą zawierać upgradeUrl.

  • dailyLimitReached— Osiągnięto dzienny limit przesłań (HTTP 429).
  • storageLimitReached— Przekroczono limit magazynu (HTTP 413).
  • fileTooLarge— Plik większy niż pozwala plan (HTTP 400).
  • 401— Brakujący, nieprawidłowy lub unieważniony klucz API.
{
  "error": "dailyLimitReached",
  "errorParams": { "limit": 1000 },
  "plan": "paid",
  "limit": 1000,
  "upgradeUrl": "https://www.phototourl.com/pricing"
}