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