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