Logo da Fotografia a URL

Documentaziun API

L'access API pretenda ina abunanza activa Pro u Premium. Autentifitgai cun ina clava API, lura chargiai maletgs en la medema biblioteca sco en il Panorm. Las quotas correspundan al plan pajà sin la web.

Maletgs da product

Chargiar in maletg

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

Parametres

Authorization
Obligatoric. Header da dumonda. Format: Bearer VOSSA_CLAV_API.
file
Obligatoric. Ina datoteca binara u datas base64.
name
Opziunal. Num da datoteca; renconuschì automaticamain cun upload multipart local.

Exempel da dumonda

Datoteca binara

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"

Per chargiar ina datoteca locala utilisai adina POST. GET n'è betg sustegnì.

Champs da resposta

id
Id da la resursa en Vossa biblioteca.
url
URL CDN per paginas da product.
fileName
Num da datoteca original.
fileSize
Grondezza da la datoteca en bytes.
mimeType
Tip MIME da la datoteca chargiada.
createdAt
Temp da chargiada en UTC, format 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"
}

Glistar maletgs

GET /api/v1/images cun page e pageSize opziunals (max 100).

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

Champs da resposta

resources
Array da maletgs: id, fileName, url, fileSize, mimeType, createdAt.
page
Numer da pagina actual.
pageSize
Elements per pagina.
total
Total da maletgs en la biblioteca.
{
  "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
}

Stizzar in maletg

DELETE /api/v1/images/:id. Allontanar la datoteca dal storage e da Vossa biblioteca.

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

Champs da resposta

success
true cur che il maletg è stizzà.
{ "success": true }

Limits

API betg disponibla sin Free. Pro e Premium duvran ils limits da chargiada, storage e grondezza da datoteca dal plan. Sche Vus surpassais in limit, l'API returna ina errur cun upgradeUrl.

Errurs

Requistass fluppadas returnan in code d'errur. Errurs da quota pon includer upgradeUrl.

  • dailyLimitReached— Limit diari da chargiada cuntanschì (HTTP 429).
  • storageLimitReached— Quota da storage surpassada (HTTP 413).
  • fileTooLarge— Datoteca pli gronda che il plan permetta (HTTP 400).
  • 401— Clava API mancanta, nunvalida u revocada.
{
  "error": "dailyLimitReached",
  "errorParams": { "limit": 1000 },
  "plan": "paid",
  "limit": 1000,
  "upgradeUrl": "https://www.phototourl.com/pricing"
}