Logo Poză în URL

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.

Imagini produs

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