Логотип Фото в 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
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 недоступний на Free. 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"
}