API для разработчиков
Загружайте файлы, создавайте ссылки и раздавайте контент из своего кода. Первый запрос можно отправить через минуту после получения ключа.
Загружайте файлы, создавайте ссылки и раздавайте контент из своего кода. Первый запрос можно отправить через минуту после получения ключа.
REST и вебхуки, подписанные ссылки, SDK для Python, Node.js, Go и PHP. Первый запрос можно отправить через минуту после получения ключа.
# Создать ссылку на файл на 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
}
import { Nubix } from "@nubix/sdk";
const nbx = new Nubix(process.env.NUBIX_KEY);
const link = await nbx.links.create({
fileId: "f_8c21a90",
expiresIn: "7d",
password: true,
});
console.log(link.url); // https://nbx.to/k9Qp2x
from nubix import Nubix
nbx = Nubix(api_key=os.environ["NUBIX_KEY"])
link = nbx.links.create(
file_id="f_8c21a90",
expires_in="7d",
password=True,
)
print(link.url) # https://nbx.to/k9Qp2x
https://api.nubix.io/v2Authorization: Bearer. Ключи создаются в кабинете, права можно ограничить.Полное описание с примерами запросов и ответов лежит в документации.
| Метод | Путь | Что делает |
|---|---|---|
| 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 | Список настроенных вебхуков |
Библиотеки выходят вместе с каждой версией API и покрыты тестами.
| Инструмент | Версия | Установка |
|---|---|---|
| Python | 2.4.1 | pip install nubix |
| Node.js и TypeScript | 2.4.0 | npm install @nubix/sdk |
| Go | 2.3.2 | go get nubix.io/sdk |
| PHP | 2.3.0 | composer require nubix/sdk |
| Командная строка | 3.8.2 | npm install -g @nubix/cli |
file.uploadedfile.downloadedlink.expiredvideo.readyМы не ломаем совместимость внутри мажорной версии. О устаревании сообщаем минимум за 12 месяцев.
Подпись вебхуков, метод статистики по ссылкам, параметр max_downloads.
Загрузка частями по 64 МБ, повторная отправка неподтверждённых блоков, песочница.
Метод сброса кэша CDN и ограничения прав ключей по папкам.
Nubix совместим со стандартными протоколами, поэтому подключается к существующим процессам без переделок.
10 ГБ хранилища и 200 ГБ трафика в месяц. Банковская карта не нужна.