Pubblicare su Novelmint
L'API di pubblicazione prende un manoscritto finito e lo mette di fronte ai lettori. Un partner crea un libro, pubblica i capitoli uno alla volta, aggiunge una copertina e poi pubblica. Tutto ciò che segue è una regola che determina se quell'ultimo passo riesce, quindi vale la pena leggerla prima di scrivere qualsiasi codice.
Cosa non può essere pubblicato qui
Due categorie vengono rifiutate al momento della pubblicazione, indipendentemente da chi le invia e da qualsiasi accordo con lo scrittore.
- Contenuto per adulti. I titoli classificati come Adulti sono solo manoscritto. Possono essere creati, modificati ed esportati, ma non possono essere elencati o venduti. La classificazione è per capitolo e si applica al libro intero, quindi un singolo capitolo può rendere un intero titolo non pubblicabile.
- Fan fiction. Le opere basate su personaggi appartenenti ad altri sono solo manoscritto su un asse separato. La piattaforma non può farne il distributore. Si tratta di diritti, non di qualità, e si applica anche quando lo scrittore detiene tutti i diritti possibili sul proprio testo.
Entrambi vengono restituiti come codici motivo leggibili dalla macchina nella chiamata di pubblicazione (manuscript_only, fan_fiction_manuscript_only), così un catalogo di qualche centinaio di titoli può essere riconciliato senza leggere testo in prosa. Un terzo codice, derivative_unresolved, significa che la revisione dei contenuti ha segnalato personaggi che potrebbero appartenere a un'altra opera e lo scrittore deve risolvere la questione prima che il titolo possa andare live.
Chi è proprietario dell'opera
I libri pubblicati per conto di uno scrittore appartengono allo scrittore. Il suo account possiede la serie, i lettori lo seguono e i guadagni sono suoi. Questo non cambia se il rapporto con il partner termina in seguito, e non è qualcosa che un partner può configurare.
Un partner che pubblica con il proprio marchio editoriale possiede i propri titoli nel modo ordinario. Le due modalità vengono scelte per libro al momento della creazione, e il meccanismo di consenso descritto di seguito si applica solo alla prima.
Come funziona il denaro
- I lettori pagano per capitolo. Lo scrittore trattiene il 70% di quanto pagano.
- Novelmint trattiene il 30%.
- Un partner guadagna una quota referral del 10% su ogni titolo che ha portato qui. Quella quota proviene dal 30% di Novelmint, mai dal 70% dello scrittore. Avere un partner non costa nulla allo scrittore.
Il 10% è automatico e per libro, il che significa che uno scrittore può portare libri da più partner e ciascun partner guadagna sui titoli che ha effettivamente portato. Non occorre firmare nulla, né configurare alcunché.
Un accordo di condivisione dei ricavi è uno strumento diverso. Prende una quota dal 70% dello scrittore, viene negoziato e controfirmato dallo scrittore, e non fa parte dell'API. Se un partner ne ha bisogno, viene gestito manualmente.
I guadagni del partner vengono trattenuti e pagati alle stesse condizioni di un autore individuale. Non esiste un piano separato per i partner.
Il consenso e a cosa serve
Un partner che dichiara di avere un accordo con uno scrittore lo fa sulla propria parola. Pubblicare il libro di qualcuno su quella sola base non è qualcosa che la piattaforma farà, quindi un titolo inviato per conto di uno scrittore viene acquisito e poi trattenuto: completamente caricato, del tutto invisibile e in attesa.
Ci sono quattro modi in cui arriva il consenso dello scrittore.
- Handoff. Lo scrittore clicca un pulsante sul sito del partner e viene reindirizzato qui per confermare nella propria sessione, poi rimandato indietro. È il percorso più rapido e la prova più solida, perché la conferma viene raccolta di persona anziché dichiarata.
- Dal dashboard. Uno scrittore che ha già un account accetta dalla propria pagina di pubblicazione. Non è coinvolta alcuna email.
- Link di rivendicazione. Se lo scrittore non ha un account, un link via email spiega cosa è stato inviato e chiede di accettare o rifiutare.
- Lo scrittore chiede. Uno scrittore può chiedere a un partner registrato di pubblicare per lui. È un'autorizzazione, non un'istruzione: il partner deve comunque inviare, e la richiesta dello scrittore non sostituisce alcun contratto tra le parti.
Quando lo scrittore accetta, tutto ciò che è trattenuto sotto quella autorizzazione viene pubblicato immediatamente, alle condizioni già indicate dal partner, e la proprietà passa allo scrittore nello stesso atto. L'autorizzazione è permanente da quel momento, quindi i titoli successivi vengono pubblicati immediatamente. Lo scrittore riceve un'email ogni volta che ciò accade.
Revoca
Uno scrittore può revocare l'autorizzazione in qualsiasi momento, dalla propria pagina di pubblicazione. La revoca blocca le future pubblicazioni. Non rimuove nulla già pubblicato e non interrompe il 10% sui titoli portati dal partner, perché quella quota registra chi ha portato il libro, non chi ha attualmente il permesso di inviarne altri.
È possibile rimuovere l'attribuzione su un titolo esistente, ma solo su richiesta scritta dello scrittore. Viene gestito manualmente ed è irreversibile: i guadagni già pagati non vengono mai riscritti.
Uno scrittore può anche rifiutare e bloccare, impedendo al partner di contattarlo di nuovo. L'indirizzo email dello scrittore bloccato viene conservato solo a tale scopo.
Versioning e cosa promettiamo di non modificare
La versione è nel percorso: /api/publish/v1/. Ogni risposta include anche un header Novelmint-Publish-Version.
All'interno della v1 possiamo aggiungere endpoint, campi di richiesta opzionali, campi di risposta e nuovi codici di errore. La tua integrazione deve ignorare qualsiasi cosa non riconosca, e questo unico requisito è ciò che consente alla v1 di migliorare senza romperti nulla.
Rimuovere un campo, rinominarlo, cambiarne il tipo o il significato di un valore esistente costituirebbe una v2, su un nuovo percorso. La v1 continua a funzionare, e qualsiasi dismissione verrebbe annunciata per iscritto con preavviso, non implicata da un numero di versione che aumenta.
Limiti pratici
- I capitoli vengono inviati uno alla volta, fino a 1 MB ciascuno. Non esiste un endpoint per l'intero libro.
- L'acquisizione è gratuita. Nulla su questo percorso addebita crediti.
- Le copertine vengono recuperate da un URL HTTPS fornito nella chiamata di pubblicazione e vengono revisionate dopo la pubblicazione, non prima.
- I token di test eseguono l'intera pipeline e si fermano prima della pubblicazione, così un'integrazione può essere testata dall'inizio alla fine senza che un titolo reale raggiunga i lettori.
- Ogni risposta riflette il riferimento del catalogo del partner e ogni scrittura è idempotente, quindi un batch ripetuto non duplica mai nulla.
Ottenere un token
I partner editoriali vengono approvati manualmente. Una volta approvati, i token vengono generati dalla scheda Token del dashboard partner. Il riferimento completo degli endpoint è pubblico ed è già disponibile qui se vuoi leggerlo prima di decidere. Candidati per diventare partner, o scopri chi pubblica già qui.