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