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