Помощь
Частые вопросы, ошибки и ссылки на документацию
Частые вопросы
Откройте раздел «Треки» → «Зарегистрировать трек». Загрузите аудиофайл (MP3/FLAC) — система автоматически вычислит ADNA-отпечаток (256 байт), BPM и тональность. Заполните сплиты (сумма долей = 100%) и нажмите «Зарегистрировать». Трек получит ISRC и попадёт в реестр с проверяемым приоритетом.
Частые ошибки API
| Код | Что значит |
|---|---|
| 401 | Нет авторизации или токен истёк. Войдите заново через Telegram. |
| 403 | Действие запрещено. Проверьте права: например, отозвать карточку может только владелец. |
| 404 | Объект не найден. Проверьте ISRC/UUID — возможно, опечатка или объект не зарегистрирован. |
| 409 | Конфликт: объект уже существует (дубликат ISRC, карточка уже отозвана, карантин ещё не истёк). |
| 422 | Валидация не пройдена: сумма сплитов ≠ 100%, ADNA не 256 байт, или расчёт каскада невозможен. |
| 429 | Слишком много запросов. Rate limit: подождите минуту или проверьте квоту устройства. |
Установка CLI (ndp-cli)
CLI нужен для маркировки треков (ADNA + NDT-манифест) и отправки квитанций прослушиваний. Требуется Python 3.10+ и ffmpeg в системе.
# 1. Клонировать и установить зависимости
git clone <repo> ndp-cli && cd ndp-cli
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
# 2. Затегировать трек (ADNA + BPM + NDT-манифест)
cd src && ../.venv/bin/python main.py tag TRACK.mp3 \
--artist 'Имя' --title 'Название' --isrc 'RU-NDP-26-00001'
--artist 'Имя' --title 'Название' --isrc 'RU-NDP-26-00001'
# 3. Проверить трек (анти-плагиат)
../.venv/bin/python main.py compare my_track.mp3 suspect.mp3
Полная документация: ndp-cli/README.md · Упаковка: pipx install ./ndp-cli