Auf Novelmint veröffentlichen

Die Publishing-API nimmt ein fertiges Manuskript entgegen und bringt es vor Leser. Ein Partner erstellt ein Buch, stellt seine Kapitel einzeln ein, fügt ein Cover hinzu und veröffentlicht es. Alles Folgende sind Regeln, die darüber entscheiden, ob dieser letzte Schritt gelingt – es lohnt sich also, dies zu lesen, bevor du Code dagegen schreibst.

Was hier nicht veröffentlicht werden kann

Zwei Kategorien werden beim Veröffentlichen abgelehnt – unabhängig davon, wer sie einreicht und was die Vereinbarung mit dem Autor besagt.

  • Inhalte für Erwachsene. Titel, die als „Adult" eingestuft werden, sind nur als Manuskript verfügbar. Sie können erstellt, bearbeitet und exportiert werden, aber nicht gelistet oder verkauft werden. Die Einstufung erfolgt pro Kapitel und überträgt sich auf das gesamte Buch – ein einziges Kapitel kann einen ganzen Titel unveröffentlichbar machen.
  • Fan-Fiction. Werke, die auf Figuren anderer aufbauen, sind auf einer eigenen Ebene ebenfalls nur als Manuskript verfügbar. Die Plattform kann nicht als Distributor fungieren. Dabei geht es um Rechte, nicht um Qualität – und das gilt selbst dann, wenn der Autor alle Rechte hält, die er an seinem eigenen Text halten kann.

Beide werden beim Veröffentlichungsaufruf als maschinenlesbare Reason-Codes zurückgegeben (manuscript_only, fan_fiction_manuscript_only), sodass ein Katalog mit einigen hundert Titeln abgeglichen werden kann, ohne englischen Fließtext lesen zu müssen. Ein dritter Code, derivative_unresolved, bedeutet, dass die Inhaltsüberprüfung Figuren markiert hat, die möglicherweise einem anderen Werk gehören – der Autor muss dies klären, bevor der Titel live gehen kann.

Wem das Werk gehört

Bücher, die im Auftrag eines Autors veröffentlicht werden, gehören dem Autor. Sein Konto besitzt die Serie, die Leser folgen ihm, und die Einnahmen gehören ihm. Das ändert sich nicht, wenn die Beziehung zum Partner später endet, und es ist nichts, was ein Partner konfigurieren kann.

Ein Partner, der unter eigenem Imprint veröffentlicht, besitzt seine Titel auf die übliche Weise. Die beiden Modi werden pro Buch bei der Erstellung gewählt, und die unten beschriebene Zustimmungslogik gilt nur für den erstgenannten.

Wie das Geld funktioniert

  • Leser zahlen pro Kapitel. Der Autor behält 70 % davon.
  • Novelmint behält 30 %.
  • Ein Partner verdient 10 % Empfehlungsanteil an jedem Titel, den er eingebracht hat. Dieser Anteil stammt aus Novelmints 30 % – niemals aus den 70 % des Autors. Einen Partner zu akzeptieren kostet einen Autor nichts.

Die 10 % sind automatisch und buchbezogen – das heißt, ein Autor kann Bücher von mehreren Partnern einbringen, und jeder Partner verdient an den Titeln, die er tatsächlich eingebracht hat. Es muss nichts unterschrieben und nichts konfiguriert werden.

Eine Umsatzbeteiligungsvereinbarung ist ein anderes Instrument. Sie nimmt einen Anteil an den 70 % des Autors, wird mit dem Autor verhandelt und gegengezeichnet, und ist nicht Teil der API. Wenn ein Partner eine solche benötigt, wird sie manuell vereinbart.

Partnereinnahmen werden zu denselben Bedingungen einbehalten und ausgezahlt wie die eines einzelnen Autors. Es gibt keinen separaten Partnertarif.

Zustimmung und wozu sie dient

Die Behauptung eines Partners, er habe eine Vereinbarung mit einem Autor, ist das Wort des Partners. Das Buch einer Person allein auf dieser Grundlage zu veröffentlichen, wird die Plattform nicht tun – daher wird ein im Auftrag eines Autors eingereichter Titel zwar vollständig aufgenommen, aber zurückgehalten: vollständig hochgeladen, vollständig unsichtbar und wartend.

Es gibt vier Wege, auf denen die Zustimmung des Autors selbst eingeht.

  • Übergabe. Der Autor klickt auf einen Button auf der Website des Partners und wird hierher weitergeleitet, um in seiner eigenen Sitzung zu bestätigen, und dann zurückgeleitet. Dies ist der schnellste Weg und der stärkste Beweis, da die Bestätigung direkt eingeholt wird, anstatt behauptet zu werden.
  • Im Dashboard. Ein Autor, der bereits ein Konto hat, stimmt auf seiner Publishing-Seite zu. Es ist keine E-Mail beteiligt.
  • Claim-Link. Hat ein Autor noch kein Konto, erklärt ein per E-Mail gesendeter Link, was eingereicht wurde, und fordert ihn auf, anzunehmen oder abzulehnen.
  • Der Autor fragt. Ein Autor kann einen gelisteten Partner bitten, für ihn zu veröffentlichen. Das ist eine Erlaubnis, keine Anweisung: Der Partner muss dennoch einreichen, und eine Anfrage des Autors setzt keinen Vertrag zwischen ihnen außer Kraft.

Wenn der Autor zustimmt, wird alles, was unter dieser Erlaubnis zurückgehalten wurde, sofort und zu den vom Partner bereits angegebenen Bedingungen veröffentlicht, und das Eigentum geht im selben Akt auf ihn über. Die Erlaubnis gilt danach dauerhaft, sodass spätere Titel sofort veröffentlicht werden. Der Autor wird jedes Mal per E-Mail benachrichtigt.

Widerruf

Ein Autor kann die Erlaubnis jederzeit von seiner eigenen Publishing-Seite aus widerrufen. Der Widerruf stoppt künftige Einreichungen. Er macht bereits veröffentlichte Inhalte nicht rückgängig und stoppt nicht die 10 % auf Titel, die der Partner eingebracht hat – denn dieser Anteil vermerkt, wer das Buch eingebracht hat, nicht wer aktuell die Erlaubnis hat, weitere einzusenden.

Die Zuordnung bei einem bestehenden Titel zu löschen ist möglich, jedoch nur auf schriftliche Anfrage des Autors. Dies wird manuell bearbeitet und gilt nur für die Zukunft: Bereits ausgezahlte Einnahmen werden niemals rückwirkend geändert.

Ein Autor kann auch ablehnen und sperren, was verhindert, dass ein Partner ihn erneut kontaktiert. Die E-Mail-Adresse eines gesperrten Autors wird ausschließlich zu diesem Zweck gespeichert.

Versionierung und was wir versprechen, nicht zu ändern

Die Version steht im Pfad: /api/publish/v1/. Jede Antwort enthält außerdem einen Novelmint-Publish-Version-Header.

Innerhalb von v1 können wir Endpunkte, optionale Anforderungsfelder, Antwortfelder und neue Fehlercodes hinzufügen. Deine Integration muss alles ignorieren, was sie nicht erkennt – und diese eine Anforderung ermöglicht es, v1 zu verbessern, ohne dich dabei zu beeinträchtigen.

Ein Feld zu entfernen, umzubenennen, seinen Typ zu ändern oder die Bedeutung eines bestehenden Werts zu ändern wäre eine v2 unter einem neuen Pfad. v1 bleibt in Betrieb, und jede Einstellung würde schriftlich und mit Vorankündigung angekündigt – nicht stillschweigend durch eine höhere Versionsnummer.

Praktische Grenzen

  • Kapitel werden einzeln eingestellt, bis zu 1 MB pro Stück. Es gibt keinen Endpunkt für das gesamte Buch.
  • Die Aufnahme ist kostenlos. Auf diesem Weg werden keine Credits abgezogen.
  • Cover werden von einer beim Veröffentlichungsaufruf angegebenen HTTPS-URL abgerufen und nach der Veröffentlichung geprüft, nicht davor.
  • Test-Token durchlaufen die gesamte Pipeline und stoppen kurz vor der Veröffentlichung – so kann eine Integration von Anfang bis Ende getestet werden, ohne dass ein echter Titel Lesern erreicht.
  • Jede Antwort gibt die eigene Katalogreferenz des Partners zurück, und jeder Schreibvorgang ist idempotent – ein wiederholter Batch dupliziert daher niemals etwas.

Einen Token erhalten

Publishing-Partner werden manuell genehmigt. Nach der Genehmigung werden Token über den Tokens-Tab des Partner-Dashboards ausgestellt. Die vollständige Endpunktreferenz ist öffentlich und bereits hier verfügbar, falls du sie vor deiner Entscheidung lesen möchtest. Bewirb dich als Partner oder sieh, wer bereits hier veröffentlicht.