Nubix

API для разработчиков

Загружайте файлы, создавайте ссылки и раздавайте контент из своего кода. Первый запрос можно отправить через минуту после получения ключа.

API, который читается с первого раза

REST и вебхуки, подписанные ссылки, SDK для Python, Node.js, Go и PHP. Первый запрос можно отправить через минуту после получения ключа.

  • Загрузка по ссылке, потоком или частями
  • События о загрузке и скачивании приходят вебхуком
  • Ограничение по IP, стране и сроку действия
  • Песочница для тестов без списания трафика
Получить ключ API
# Создать ссылку на файл на 7 дней
curl -X POST https://api.nubix.io/v2/links \
  -H "Authorization: Bearer $NUBIX_KEY" \
  -d file_id=f_8c21a90 \
  -d expires_in=7d \
  -d password=required

{
  "url": "https://nbx.to/k9Qp2x",
  "expires_at": "2026-11-20T12:00:00Z",
  "downloads_left": null
}

Что нужно знать перед началом

Базовый адрес
https://api.nubix.io/v2
Аутентификация
Ключ в заголовке Authorization: Bearer. Ключи создаются в кабинете, права можно ограничить.
Формат
JSON в запросах и ответах, коды ответа по HTTP, время в формате ISO 8601.
Лимиты
600 запросов в минуту на ключ. Загрузка частями не ограничена по числу блоков.
SDK
Python, Node.js, Go и PHP. Версии выходят вместе с API.
Песочница
Отдельный адрес для тестов, трафик не списывается, файлы живут сутки.
Открыть документацию

Основные методы

Полное описание с примерами запросов и ответов лежит в документации.

МетодПутьЧто делает
POST/v2/filesЗагрузить файл до 5 ГБ одним запросом
POST/v2/uploadsОткрыть сессию загрузки частями для больших файлов
GET/v2/files/{id}Получить сведения о файле
DELETE/v2/files/{id}Удалить файл
POST/v2/linksСоздать ссылку с паролем, сроком и лимитом
GET/v2/links/{id}/statsСтатистика скачиваний по странам и времени
POST/v2/videosОтправить видео на обработку
POST/v2/cache/purgeСбросить кэш CDN по пути или тегу
GET/v2/webhooksСписок настроенных вебхуков

SDK и инструменты

Библиотеки выходят вместе с каждой версией API и покрыты тестами.

ИнструментВерсияУстановка
Python2.4.1pip install nubix
Node.js и TypeScript2.4.0npm install @nubix/sdk
Go2.3.2go get nubix.io/sdk
PHP2.3.0composer require nubix/sdk
Командная строка3.8.2npm install -g @nubix/cli

События вебхуков

file.uploaded
Файл полностью загружен и доступен для ссылок.
file.downloaded
Файл скачан по ссылке. В событии есть страна и тип клиента.
link.expired
Срок действия ссылки закончился или исчерпан лимит скачиваний.
video.ready
Видео обработано, версии и плеер готовы.

Версии API

Мы не ломаем совместимость внутри мажорной версии. О устаревании сообщаем минимум за 12 месяцев.

Работает с тем, чем вы уже пользуетесь

Nubix совместим со стандартными протоколами, поэтому подключается к существующим процессам без переделок.

Начните с бесплатного тарифа

10 ГБ хранилища и 200 ГБ трафика в месяц. Банковская карта не нужна.