Лого на Снимка към URL

API документация

API достъпът изисква активен абонамент Pro или Premium. Удостоверете се с API ключ и качвайте изображения в същата библиотека като в Таблото. Квотите следват платения ви план в сайта.

Продуктови изображения

Качване на изображение

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

Параметри

Authorization
Задължително. Заглавка на заявката. Формат: Bearer ВАШИЯТ_API_КЛЮЧ.
file
Задължително. Двоичен файл или base64 данни.
name
Незадължително. Име на файл; разпознава се автоматично при локален multipart качване.

Примерна заявка

Двоичен файл

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"

За качване на локален файл винаги използвайте POST. GET не се поддържа.

Полета в отговора

id
Идентификатор на ресурса в библиотеката ви.
url
CDN URL за продуктови страници.
fileName
Оригинално име на файла.
fileSize
Размер на файла в байтове.
mimeType
MIME тип на качения файл.
createdAt
Час на качване в UTC, формат 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"
}

Списък с изображения

GET /api/v1/images с по желание page и pageSize (макс. 100).

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

Полета в отговора

resources
Масив от изображения: id, fileName, url, fileSize, mimeType, createdAt.
page
Номер на текущата страница.
pageSize
Елементи на страница.
total
Общ брой изображения в библиотеката.
{
  "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
}

Изтриване на изображение

DELETE /api/v1/images/:id. Премахва файла от хранилището и библиотеката ви.

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

Полета в отговора

success
true, когато изображението е изтрито.
{ "success": true }

Ограничения

API не е наличен в безплатния план. Pro и Premium използват лимитите за качване, място и размер на файла от вашия план. При превишаване API връща грешка с upgradeUrl.

Грешки

Неуспешните заявки връщат код за грешка. Грешките за квота може да включват upgradeUrl.

  • dailyLimitReached— Достигнат е дневният лимит за качване (HTTP 429).
  • storageLimitReached— Превишена е квотата за място (HTTP 413).
  • fileTooLarge— Файлът е по-голям от позволеното в плана (HTTP 400).
  • 401— Липсващ, невалиден или отменен API ключ.
{
  "error": "dailyLimitReached",
  "errorParams": { "limit": 1000 },
  "plan": "paid",
  "limit": 1000,
  "upgradeUrl": "https://www.phototourl.com/pricing"
}