Fotka na URL logo

Dokumentácia API

Prístup k API vyžaduje aktívne predplatné Pro alebo Premium. Overte sa API kľúčom a nahrávajte obrázky do rovnakej knižnice ako v Prehľade. Kvóty zodpovedajú platenému tarifu na webe.

Produktové obrázky

Nahrať obrázok

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

Parametre

Authorization
Povinné. Hlavička požiadavky. Formát: Bearer VÁŠ_API_KĽÚČ.
file
Povinné. Binárny súbor alebo base64 údaje.
name
Voliteľné. Názov súboru; pri lokálnom multipart upload-e sa rozpozná automaticky.

Príklad požiadavky

Binárny súbor

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"

Na nahratie lokálneho súboru vždy použite POST. GET nie je podporované.

Polia odpovede

id
ID zdroja vo vašej knižnici.
url
CDN URL pre produktové stránky.
fileName
Pôvodný názov súboru.
fileSize
Veľkosť súboru v bajtoch.
mimeType
MIME typ nahraného súboru.
createdAt
Čas nahrania v UTC, formát 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"
}

Vypísať obrázky

GET /api/v1/images s voliteľným page a pageSize (max. 100).

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

Polia odpovede

resources
Pole obrázkov: id, fileName, url, fileSize, mimeType, createdAt.
page
Číslo aktuálnej stránky.
pageSize
Položiek na stránku.
total
Celkový počet obrázkov v kniž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
}

Zmazať obrázok

DELETE /api/v1/images/:id. Odstráni súbor z úložiska aj knižnice.

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

Polia odpovede

success
true, keď bol obrázok zmazaný.
{ "success": true }

Limity

API nie je dostupné vo Free tarife. Pro a Premium používajú limity nahrávania, úložiska a veľkosti súboru vášho tarifu. Pri prekročení API vráti chybu s upgradeUrl.

Chyby

Neúspešné požiadavky vracajú chybový kód. Chyby kvóty môžu obsahovať upgradeUrl.

  • dailyLimitReached— Dosiahnutý denný limit nahrávania (HTTP 429).
  • storageLimitReached— Prekročená kvóta úložiska (HTTP 413).
  • fileTooLarge— Súbor je väčší, než tarif povoľuje (HTTP 400).
  • 401— Chýbajúci, neplatný alebo zrušený API kľúč.
{
  "error": "dailyLimitReached",
  "errorParams": { "limit": 1000 },
  "plan": "paid",
  "limit": 1000,
  "upgradeUrl": "https://www.phototourl.com/pricing"
}