Logo Foto na URL

Dokumentace API

Přístup k API vyžaduje aktivní předplatné Pro nebo Premium. Ověřte se API klíčem a nahrávejte obrázky do stejné knihovny jako na Nástěnce. Kvóty odpovídají placenému tarifu na webu.

Produktové obrázky

Nahrát obrázek

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

Parametry

Authorization
Povinné. Hlavička požadavku. Formát: Bearer VÁŠ_API_KLÍČ.
file
Povinné. Binární soubor nebo base64 data.
name
Volitelné. Název souboru; při lokálním multipart uploadu se rozpozná automaticky.

Příklad požadavku

Binární soubor

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"

Pro nahrání lokálního souboru vždy použijte POST. GET není podporováno.

Pole odpovědi

id
ID zdroje ve vaší knihovně.
url
CDN URL pro produktové stránky.
fileName
Původní název souboru.
fileSize
Velikost souboru v bajtech.
mimeType
MIME typ nahraného souboru.
createdAt
Čas nahrání 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"
}

Vypsat obrázky

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

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

Pole odpovědi

resources
Pole obrázků: id, fileName, url, fileSize, mimeType, createdAt.
page
Číslo aktuální stránky.
pageSize
Položek na stránku.
total
Celkový počet obrázků v knihovně.
{
  "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
}

Smazat obrázek

DELETE /api/v1/images/:id. Odstraní soubor z úložiště i knihovny.

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

Pole odpovědi

success
true, když byl obrázek smazán.
{ "success": true }

Limity

API není dostupné ve Free tarifu. Pro a Premium používají limity nahrávání, úložiště a velikosti souboru vašeho tarifu. Při překročení API vrátí chybu s upgradeUrl.

Chyby

Neúspěšné požadavky vracejí chybový kód. Chyby kvóty mohou obsahovat upgradeUrl.

  • dailyLimitReached— Dosažen denní limit nahrávání (HTTP 429).
  • storageLimitReached— Překročena kvóta úložiště (HTTP 413).
  • fileTooLarge— Soubor je větší, než tarif povoluje (HTTP 400).
  • 401— Chybějící, neplatný nebo zrušený API klíč.
{
  "error": "dailyLimitReached",
  "errorParams": { "limit": 1000 },
  "plan": "paid",
  "limit": 1000,
  "upgradeUrl": "https://www.phototourl.com/pricing"
}