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