Publiceren op Novelmint
De publishing API neemt een voltooid manuscript en plaatst het voor lezers. Een partner maakt een boek aan, plaatst de hoofdstukken één voor één, voegt een omslag toe en publiceert vervolgens. Alles hieronder is een regel die bepaalt of die laatste stap slaagt — het is de moeite waard dit te lezen voordat je code schrijft.
Wat hier niet gepubliceerd kan worden
Twee categorieën worden geweigerd bij het publiceren, ongeacht wie ze indient of wat de afspraak met de schrijver inhoudt.
- Volwasseneninhoud. Titels die als Volwassen worden geclassificeerd, zijn alleen als manuscript beschikbaar. Ze kunnen worden aangemaakt, bewerkt en geëxporteerd, maar niet worden vermeld of verkocht. Classificatie geldt per hoofdstuk en wordt opgerold naar het boek, dus één hoofdstuk kan een hele titel onpubliceerbaar maken.
- Fanfictie. Werk dat gebaseerd is op personages van iemand anders is op een aparte as alleen als manuscript beschikbaar. Het platform kan niet optreden als distributeur. Dit gaat over rechten, niet over kwaliteit, en het geldt ook als de schrijver alle rechten bezit die ze in hun eigen tekst kunnen bezitten.
Beide worden als machine-leesbare redencodes teruggegeven bij de publicatieoproep (manuscript_only, fan_fiction_manuscript_only), zodat een catalogus van enkele honderden titels kan worden gecontroleerd zonder Engelse tekst te lezen. Een derde code, derivative_unresolved, betekent dat de inhoudscontrole personages heeft gemarkeerd die mogelijk van een ander werk zijn en dat de schrijver dit moet oplossen voordat de titel live kan gaan.
Wie het werk bezit
Boeken die namens een schrijver worden gepubliceerd, zijn eigendom van de schrijver. Hun account bezit de serie, lezers volgen hen en de inkomsten zijn van hen. Dat verandert niet als de samenwerking met de partner later eindigt, en het is iets wat een partner niet kan instellen.
Een partner die onder eigen imprint publiceert, bezit zijn titels op de gebruikelijke manier. De twee modi worden per boek gekozen bij aanmaak, en het toestemmingsmechanisme hieronder geldt alleen voor de eerste.
Hoe de inkomsten werken
- Lezers betalen per hoofdstuk. De schrijver houdt 70% van wat zij betalen.
- Novelmint houdt 30%.
- Een partner verdient een verwijzingsaandeel van 10% op elke titel die hij heeft aangebracht. Dat aandeel komt uit Novelmints 30%, nooit uit de 70% van de schrijver. Een partner accepteren kost een schrijver niets.
De 10% is automatisch en per boek, wat betekent dat één schrijver boeken van meerdere partners kan aanbrengen en elke partner verdient op de titels die hij daadwerkelijk heeft aangebracht. Er hoeft niets voor ondertekend of ingesteld te worden.
Een inkomstendelingsovereenkomst is een ander instrument. Het neemt een deel van de eigen 70% van de schrijver, wordt onderhandeld en mede-ondertekend door de schrijver, en maakt geen deel uit van de API. Als een partner er een nodig heeft, wordt dit handmatig geregeld.
Partnerinkomsten worden bewaard en uitbetaald op dezelfde voorwaarden als die van een individuele auteur. Er is geen apart partnerschema.
Toestemming, en waarvoor het dient
Een partner die beweert een overeenkomst met een schrijver te hebben, is slechts de bewering van de partner. Een boek uitsluitend op die basis publiceren is iets wat het platform niet doet; een namens een schrijver ingediende titel wordt dan ook opgenomen en vervolgens bewaard: volledig geüpload, volledig onzichtbaar en wachtend.
Er zijn vier manieren waarop de toestemming van de schrijver zelf binnenkomt.
- Handoff. De schrijver klikt op een knop op de site van de partner en wordt hierheen doorgestuurd om te bevestigen in hun eigen sessie, waarna ze teruggestuurd worden. Dit is de snelste route en het sterkste bewijs, omdat de bevestiging direct wordt verzameld in plaats van beweerd.
- Via dashboard. Een schrijver die al een account heeft, accepteert op hun publicatiepagina. Er is geen e-mail bij betrokken.
- Claimlink. Als een schrijver geen account heeft, legt een gemailde link uit wat er is ingediend en wordt gevraagd of ze willen accepteren of weigeren.
- De schrijver vraagt het. Een schrijver kan een geregistreerde partner vragen om voor hen te publiceren. Dat is toestemming, geen instructie: de partner moet nog steeds indienen, en een vraag van de schrijver heeft geen voorrang op eventuele contracten tussen hen.
Wanneer de schrijver akkoord gaat, wordt alles wat onder die toestemming is bewaard tegelijk gepubliceerd, op de voorwaarden die de partner al heeft aangegeven, en gaat het eigendom in dezelfde handeling naar hen over. Toestemming is daarna blijvend, zodat latere titels direct worden gepubliceerd. De schrijver ontvangt elke keer een e-mail wanneer dat gebeurt.
Intrekking
Een schrijver kan toestemming op elk moment intrekken via hun eigen publicatiepagina. Intrekking stopt toekomstige indieningen. Het haalt niets wat al live is offline, en stopt de 10% op titels die de partner heeft aangebracht niet, omdat dat aandeel bijhoudt wie het boek heeft aangebracht en niet wie momenteel toestemming heeft om meer in te sturen.
Attributie op een bestaande titel verwijderen is mogelijk, maar uitsluitend op schriftelijk verzoek van de schrijver. Dit wordt handmatig afgehandeld en is alleen voorwaarts: al uitbetaalde inkomsten worden nooit herzien.
Een schrijver kan ook weigeren en blokkeren, waardoor een partner geen contact meer met hen kan opnemen. Het e-mailadres van een geblokkeerde schrijver wordt uitsluitend voor dat doel bewaard.
Versiebeheer, en wat we beloven niet te breken
De versie staat in het pad: /api/publish/v1/. Elke respons bevat ook een Novelmint-Publish-Version-header.
Binnen v1 kunnen we endpoints, optionele aanvraagvelden, responsvelden en nieuwe foutcodes toevoegen. Je integratie moet alles negeren wat het niet herkent — en dat is de enige vereiste die v1 in staat stelt te verbeteren zonder jou te breken.
Een veld verwijderen, hernoemen, het type wijzigen of de betekenis van een bestaande waarde veranderen zou een v2 zijn, op een nieuw pad. v1 blijft werken, en eventuele afschaffing zou schriftelijk en met vooraankondiging worden bekendgemaakt, niet impliciet door een versienummer dat omhoog gaat.
Praktische limieten
- Hoofdstukken worden één voor één geplaatst, maximaal 1 MB per stuk. Er is geen eindpunt voor een heel boek.
- Opname is gratis. Niets op dit pad brengt credits in rekening.
- Omslagen worden opgehaald van een HTTPS URL die bij de publicatieoproep wordt opgegeven, en worden na publicatie beoordeeld, niet daarvoor.
- Testtokens doorlopen de volledige pipeline en stoppen net voor publicatie, zodat een integratie van begin tot eind getest kan worden zonder dat een echte titel lezers bereikt.
- Elke respons geeft de eigen catalogusreferentie van de partner terug, en elke schrijfactie is idempotent, zodat een herhaalde batch nooit duplicaten aanmaakt.
Een token verkrijgen
Uitgeverijpartners worden handmatig goedgekeurd. Na goedkeuring worden tokens aangemaakt via het tabblad Tokens van het partnerdashboard. De volledige endpoint-referentie is openbaar en al hier beschikbaar als je die wilt lezen voordat je beslist. Solliciteer als partner, of zie wie er al publiceert.