API приёма и раздачи файлов
Сервис принимает медиафайлы и товарные фиды от систем синхронизации каталога продавцов, проверяет их и раздаёт через ближайший edge-узел. Ниже — актуальные эндпоинты этого узла.
Аутентификация — заголовок Authorization: Bearer <api_key>, ключ выдаётся при подключении интеграции. Все ответы в формате JSON, кроме случаев отдачи самого файла.
Эндпоинты
Основной набор операций для загрузки, проверки статуса и раздачи файлов.
POST
/api/v2/uploads
Загрузить файл или пакет файлов
Принимает multipart-запрос, ставит файл в очередь обработки (проверка формата, антивирус, генерация превью) и возвращает идентификатор для отслеживания статуса.
| Поле | Тип | Описание |
|---|---|---|
| file | binary | содержимое файла, до 512 МБ |
| category | string | media / feed / document |
| callback_url | string, опц. | куда отправить уведомление по завершении |
GET
/api/v2/uploads/{id}
Статус обработки
Возвращает текущий статус загрузки:
queued, processing, ready или rejected, с причиной при отклонении.
GET
/cdn/{id}
Раздача файла
Отдаёт готовый файл с ближайшего edge-узла. Поддерживает
Range-запросы и условные заголовки (ETag, If-None-Match).
DELETE
/api/v2/uploads/{id}
Удалить файл
Помечает файл к удалению и снимает с раздачи на edge-узлах в течение нескольких минут.
GET
/api/v2/health
Проверка доступности узла
Лёгкий health-check без авторизации, используется системами мониторинга интеграций.
Пример запроса
Загрузка файла с указанием категории и колбэка.
POST /api/v2/uploads HTTP/1.1 Host: cdn-003.kjgit81eda.site Authorization: Bearer sk_live_9f2a1c... Content-Type: multipart/form-data; boundary=----form → 202 Accepted { "id": "up_8f2ac91e", "status": "queued", "eta_seconds": 4 }