API-dokumentáció
Az API-hozzáféréshez aktív Pro vagy Premium előfizetés kell. Hitelesítsen API-kulccsal, majd töltsön fel képeket ugyanabba a könyvtárba, mint a Dashboardon. A keretek megegyeznek a webhely fizetős csomagjával.
Kép feltöltése
POST /api/v1/upload multipart/form-data formában.
Paraméterek
Authorization- Kötelező. Kérésfejléc. Formátum: Bearer AZ_API_KULCSA.
file- Kötelező. Bináris fájl vagy base64 adat.
name- Opcionális. Fájlnév; helyi multipart feltöltésnél automatikusan felismert.
Példa kérés
Bináris fájl
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"
Helyi fájl feltöltéséhez mindig POST-ot használjon. A GET nem támogatott.
Válaszmezők
id- Erőforrás-azonosító a könyvtárában.
url- CDN-URL a termékoldalakhoz.
fileName- Eredeti fájlnév.
fileSize- Fájlméret bájtban.
mimeType- A feltöltött fájl MIME-típusa.
createdAt- Feltöltési idő UTC-ben, formátum 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"
}Képek listázása
GET /api/v1/images opcionális page és pageSize paraméterekkel (max. 100).
curl "https://phototourl.com/api/v1/images?page=1&pageSize=20" \ -H "Authorization: Bearer ptu_live_YOUR_KEY"
Válaszmezők
resources- Képek tömbje: id, fileName, url, fileSize, mimeType, createdAt.
page- Aktuális oldalszám.
pageSize- Elemek oldalanként.
total- Összes kép a könyvtárban.
{
"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
}Kép törlése
DELETE /api/v1/images/:id. Eltávolítja a fájlt a tárhelyről és a könyvtárból.
curl -X DELETE https://phototourl.com/api/v1/images/RESOURCE_ID \ -H "Authorization: Bearer ptu_live_YOUR_KEY"
Válaszmezők
success- true, ha a kép törölve lett.
{ "success": true }Limitek
Az API Free csomagon nem érhető el. A Pro és Premium a csomag feltöltési, tárhely- és fájlméret-limitjeit használja. Túllépéskor az API hibát ad upgradeUrl-lel.
Hibák
A sikertelen kérések hibakódot adnak vissza. A kerethibák tartalmazhatnak upgradeUrl-t.
dailyLimitReached— Napi feltöltési limit elérve (HTTP 429).storageLimitReached— Tárhelykeret túllépve (HTTP 413).fileTooLarge— A fájl nagyobb, mint a csomag engedi (HTTP 400).401— Hiányzó, érvénytelen vagy visszavont API-kulcs.
{
"error": "dailyLimitReached",
"errorParams": { "limit": 1000 },
"plan": "paid",
"limit": 1000,
"upgradeUrl": "https://www.phototourl.com/pricing"
}