Fotó Linkké logo

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.

Termékképek

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