Публикация на Novelmint

Publishing API принимает готовую рукопись и представляет её читателям. Партнёр создаёт книгу, публикует главы по одной, прикрепляет обложку и выпускает книгу. Всё, что описано ниже, — это правила, определяющие, будет ли последний шаг успешным; стоит прочитать их перед тем, как писать код.

Что здесь нельзя публиковать

Две категории отклоняются на этапе публикации — вне зависимости от того, кто их отправил и что прописано в договоре с автором.

  • Контент для взрослых. Произведения с пометкой Adult доступны только в режиме рукописи. Их можно создавать, редактировать и экспортировать, но нельзя размещать в каталоге или продавать. Классификация задаётся на уровне главы и распространяется на всю книгу, поэтому одна глава может сделать всё произведение непубликуемым.
  • Фанфикшн. Произведения, основанные на чужих персонажах, также доступны только в режиме рукописи — по отдельному критерию. Платформа не может выступать их дистрибьютором. Это вопрос прав, а не качества, и правило действует даже в тех случаях, когда автор владеет всеми правами, которые только мог получить на собственный текст.

Оба случая возвращаются как машиночитаемые коды причин в вызове публикации (manuscript_only, fan_fiction_manuscript_only), поэтому каталог из нескольких сотен произведений можно свериться без чтения текстовых описаний. Третий код, derivative_unresolved, означает, что проверка контента выявила персонажей, которые могут принадлежать другому произведению, и автор должен урегулировать этот вопрос, прежде чем произведение станет доступным.

Кому принадлежат права

Книги, опубликованные от имени автора, принадлежат автору. Их аккаунт владеет серией, читатели подписаны на них, а доход — их. Это не изменится, если впоследствии отношения с партнёром прекратятся, и партнёр не может этого изменить.

Партнёр, публикующий под собственным импринтом, владеет своими произведениями в обычном порядке. Режим выбирается для каждой книги при создании; механизм получения согласия, описанный ниже, применяется только к первому варианту.

Как работает монетизация

  • Читатели платят за каждую главу. Автор получает 70% от их оплаты.
  • Novelmint получает 30%.
  • Партнёр получает реферальные 10% с каждого привлечённого произведения. Эта доля вычитается из 30% Novelmint, а не из 70% автора. Участие в партнёрской программе ничего не стоит автору.

10% начисляются автоматически и за каждую книгу: один автор может сотрудничать с несколькими партнёрами, и каждый из них получает выплаты только за те произведения, которые он действительно привлёк. Никаких соглашений подписывать и ничего настраивать не нужно.

Соглашение о разделе доходов — это отдельный инструмент. Оно затрагивает долю автора в 70%, заключается и подписывается автором лично и не является частью API. Если партнёру оно необходимо, оно оформляется вручную.

Выплаты партнёрам удерживаются и производятся на тех же условиях, что и выплаты индивидуальным авторам. Отдельного партнёрского графика выплат нет.

Согласие и его назначение

Утверждение партнёра о наличии договорённости с автором остаётся лишь его словами. Публиковать чью-то книгу только на этом основании платформа не станет: произведение, поданное от имени автора, принимается и остаётся на удержании — полностью загруженное, полностью невидимое и ожидающее подтверждения.

Есть четыре способа получить согласие непосредственно от автора.

  • Передача (Handoff). Автор нажимает кнопку на сайте партнёра и перенаправляется сюда для подтверждения в своей сессии, после чего возвращается обратно. Это самый быстрый и надёжный способ: подтверждение получается напрямую, а не заявляется со стороны.
  • Через панель управления. Автор, уже имеющий аккаунт, принимает согласие на своей странице публикаций. Email не требуется.
  • Ссылка для подтверждения. Если у автора нет аккаунта, ему отправляется письмо со ссылкой, объясняющей, что было прислано, с предложением принять или отклонить.
  • По запросу автора. Автор может попросить партнёра из каталога опубликовать произведение от его имени. Это разрешение, а не инструкция: партнёр всё равно должен подать заявку, и запрос автора не отменяет никаких договорённостей между ними.

Когда автор даёт согласие, все удерживаемые под этим разрешением материалы публикуются одновременно на уже заявленных партнёром условиях, и права переходят к автору в тот же момент. После этого разрешение считается постоянным, и последующие произведения публикуются сразу. Автор получает уведомление по email каждый раз, когда это происходит.

Отзыв разрешения

Автор может отозвать разрешение в любой момент — со своей страницы публикаций. Отзыв прекращает приём новых материалов от партнёра. Уже опубликованные произведения при этом не снимаются, и 10% за привлечённые партнёром произведения также сохраняются: эта доля фиксирует, кто принёс книгу, а не кто сейчас имеет право отправлять новые.

Снять атрибуцию с уже опубликованного произведения можно только по письменному запросу автора. Это делается вручную и только в перспективном направлении: уже выплаченный доход никогда не пересматривается.

Автор также может отклонить запрос и заблокировать партнёра — после этого партнёр не сможет снова с ним связаться. Email-адрес заблокированного автора сохраняется исключительно для этой цели.

Версионирование и что мы обязуемся не ломать

Версия указана в пути: /api/publish/v1/. Каждый ответ также содержит заголовок Novelmint-Publish-Version.

В рамках v1 мы можем добавлять эндпоинты, необязательные поля запросов, поля ответов и новые коды ошибок. Ваша интеграция должна игнорировать всё, что ей неизвестно, — это единственное требование, которое позволяет v1 развиваться без нарушения совместимости.

Удаление поля, его переименование, изменение типа или смысла существующего значения потребует v2 на новом пути. v1 продолжает работать, а любое прекращение поддержки будет объявлено письменно с заблаговременным уведомлением, а не подразумеваться по смене номера версии.

Практические ограничения

  • Главы публикуются по одной, объёмом до 1 МБ каждая. Эндпоинта для загрузки целой книги нет.
  • Приём рукописей бесплатен. Никаких списаний кредитов на этом пути нет.
  • Обложки загружаются с HTTPS URL, указанного в вызове публикации, и проверяются после публикации, а не до.
  • Тестовые токены запускают полный pipeline и останавливаются перед публикацией, поэтому интеграцию можно проверить от начала до конца без того, чтобы реальное произведение попало к читателям.
  • Каждый ответ содержит ваш собственный каталожный идентификатор, а каждая операция записи идемпотентна — повторная отправка пакета никогда ничего не дублирует.

Получение токена

Партнёры-издатели проходят ручное одобрение. После одобрения токены создаются на вкладке «Токены» в панели управления партнёра. Полный справочник эндпоинтов общедоступен и уже доступен здесь, если вы хотите ознакомиться с ним перед принятием решения. Подайте заявку на участие в партнёрской программе или посмотрите, кто уже публикует здесь.