API dokumentacija
API zahtijeva aktivnu Pro ili Premium pretplatu. Autenticirajte se API ključem, zatim učitajte slike u istu knjižnicu kao u Nadzornoj ploči. Kvote odgovaraju plaćenom planu na webu.
Učitaj sliku
POST /api/v1/upload s multipart/form-data.
Parametri
Authorization- Obavezno. Zaglavlje zahtjeva. Format: Bearer VAŠ_API_KLJUČ.
file- Obavezno. Binarna datoteka ili base64 podaci.
name- Neobavezno. Naziv datoteke; automatski se prepoznaje pri lokalnom multipart uploadu.
Primjer zahtjeva
Binarna datoteka
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"
Za upload lokalne datoteke uvijek koristite POST. GET nije podržan.
Polja odgovora
id- Id resursa u knjižnici.
url- CDN URL za stranice proizvoda.
fileName- Izvorno ime datoteke.
fileSize- Veličina datoteke u bajtovima.
mimeType- MIME tip učitane datoteke.
createdAt- Vrijeme učitavanja u 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"
}Popis slika
GET /api/v1/images s opcionalnim page i pageSize (max 100).
curl "https://phototourl.com/api/v1/images?page=1&pageSize=20" \ -H "Authorization: Bearer ptu_live_YOUR_KEY"
Polja odgovora
resources- Niz slika: id, fileName, url, fileSize, mimeType, createdAt.
page- Trenutačni broj stranice.
pageSize- Stavki po stranici.
total- Ukupno slika u knjižnici.
{
"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
}Izbriši sliku
DELETE /api/v1/images/:id. Uklanja datoteku iz pohrane i knjižnice.
curl -X DELETE https://phototourl.com/api/v1/images/RESOURCE_ID \ -H "Authorization: Bearer ptu_live_YOUR_KEY"
Polja odgovora
success- true kad je slika izbrisana.
{ "success": true }Ograničenja
API nije dostupan na besplatnom planu. Pro i Premium koriste limite učitavanja, prostora i veličine datoteke plana. Kad premašite limit, API vraća grešku s upgradeUrl.
Greške
Neuspješni zahtjevi vraćaju kod greške. Greške kvota mogu uključivati upgradeUrl.
dailyLimitReached— Dnevni limit učitavanja dosegnut (HTTP 429).storageLimitReached— Kvota pohrane premašena (HTTP 413).fileTooLarge— Datoteka veća od dozvoljene planom (HTTP 400).401— Nedostaje, nevažeći ili opozvan API ključ.
{
"error": "dailyLimitReached",
"errorParams": { "limit": 1000 },
"plan": "paid",
"limit": 1000,
"upgradeUrl": "https://www.phototourl.com/pricing"
}