Slika u URL logo

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.

Slike proizvoda

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