Documentație API
Accesul API necesită un abonament activ Pro sau Premium. Autentifică-te cu o cheie API, apoi încarcă imagini în aceeași bibliotecă ca în Panou. Cotele urmează planul plătit de pe site.
Încarcă o imagine
POST /api/v1/upload cu multipart/form-data.
Parametri
Authorization- Obligatoriu. Antetul cererii. Format: Bearer CHEIA_API.
file- Obligatoriu. Un fișier binar sau date base64.
name- Opțional. Numele fișierului; detectat automat la upload multipart local.
Exemplu de cerere
Fișier binar
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"
Pentru încărcarea unui fișier local folosiți întotdeauna POST. GET nu este acceptat.
Câmpuri răspuns
id- Id-ul resursei în bibliotecă.
url- URL CDN pentru pagini de produs.
fileName- Numele original al fișierului.
fileSize- Dimensiunea fișierului în octeți.
mimeType- Tipul MIME al fișierului încărcat.
createdAt- Ora încărcării în 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"
}Listează imagini
GET /api/v1/images cu page și pageSize opționale (max. 100).
curl "https://phototourl.com/api/v1/images?page=1&pageSize=20" \ -H "Authorization: Bearer ptu_live_YOUR_KEY"
Câmpuri răspuns
resources- Array de imagini: id, fileName, url, fileSize, mimeType, createdAt.
page- Numărul paginii curente.
pageSize- Elemente pe pagină.
total- Total imagini în bibliotecă.
{
"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
}Șterge o imagine
DELETE /api/v1/images/:id. Elimină fișierul din stocare și din bibliotecă.
curl -X DELETE https://phototourl.com/api/v1/images/RESOURCE_ID \ -H "Authorization: Bearer ptu_live_YOUR_KEY"
Câmpuri răspuns
success- true când imaginea a fost ștearsă.
{ "success": true }Limite
API nu este disponibil pe Free. Pro și Premium folosesc limitele de încărcare, stocare și dimensiune fișier ale planului. Când depășești o limită, API returnează o eroare cu upgradeUrl.
Erori
Cereri eșuate returnează un cod de eroare. Erorile de cotă pot include upgradeUrl.
dailyLimitReached— Limita zilnică de încărcare atinsă (HTTP 429).storageLimitReached— Cota de stocare depășită (HTTP 413).fileTooLarge— Fișier mai mare decât permite planul (HTTP 400).401— Cheie API lipsă, invalidă sau revocată.
{
"error": "dailyLimitReached",
"errorParams": { "limit": 1000 },
"plan": "paid",
"limit": 1000,
"upgradeUrl": "https://www.phototourl.com/pricing"
}