Документація 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"
}