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