Publier sur Novelmint

L'API de publication prend un manuscrit terminé et le soumet aux lecteurs. Un partenaire crée un livre, publie ses chapitres un par un, ajoute une couverture, puis publie. Tout ce qui suit est une règle qui détermine si cette dernière étape réussit — il vaut donc mieux la lire avant d'écrire du code.

Ce qui ne peut pas être publié ici

Deux catégories sont refusées au moment de la publication, quel que soit le soumetteur ou l'accord avec l'auteur.

  • Contenu adulte. Les titres classés Adulte sont réservés au manuscrit. Ils peuvent être créés, modifiés et exportés, mais ne peuvent pas être listés ni vendus. La classification s'applique par chapitre et remonte au livre entier : un seul chapitre peut rendre tout un titre non publiable.
  • Fan fiction. Les œuvres fondées sur des personnages appartenant à autrui sont également réservées au manuscrit, selon un axe distinct. La plateforme ne peut pas en être le distributeur. Il s'agit d'une question de droits, non de qualité — même si l'auteur détient tous les droits qu'il pourrait détenir sur son propre texte.

Ces deux cas sont renvoyés sous forme de codes de raison lisibles par machine lors de l'appel de publication (manuscript_only, fan_fiction_manuscript_only), ce qui permet de réconcilier un catalogue de plusieurs centaines de titres sans lire de texte en clair. Un troisième code, derivative_unresolved, signifie que la vérification du contenu a signalé des personnages pouvant appartenir à une autre œuvre, et l'auteur doit résoudre ce point avant la mise en ligne.

À qui appartient l'œuvre

Les livres publiés au nom d'un auteur lui appartiennent. Son compte possède la série, les lecteurs le suivent, et les gains lui reviennent. Cela ne change pas si la relation avec le partenaire prend fin ultérieurement, et ce n'est pas quelque chose qu'un partenaire peut configurer.

Un partenaire publiant sous sa propre marque possède ses titres de manière ordinaire. Les deux modes sont choisis par livre à la création, et le mécanisme de consentement ci-dessous ne s'applique qu'au premier.

Comment fonctionne l'argent

  • Les lecteurs paient par chapitre. L'auteur conserve 70 % de ce qu'ils paient.
  • Novelmint conserve 30 %.
  • Un partenaire perçoit une commission de parrainage de 10 % sur chaque titre qu'il a apporté. Cette part est prélevée sur les 30 % de Novelmint, jamais sur les 70 % de l'auteur. Accepter un partenaire ne coûte rien à l'auteur.

Les 10 % sont automatiques et par livre, ce qui signifie qu'un auteur peut apporter des livres de plusieurs partenaires et chaque partenaire est rémunéré sur les titres qu'il a effectivement apportés. Rien n'est à signer ni à configurer.

Un accord de partage des revenus est un instrument distinct. Il prend une part des 70 % de l'auteur, est négocié et contresigné par lui, et ne fait pas partie de l'API. S'il en faut un, il est arrangé manuellement.

Les gains des partenaires sont retenus et versés dans les mêmes conditions que ceux d'un auteur individuel. Il n'existe pas de calendrier partenaire distinct.

Le consentement et son utilité

Un partenaire affirmant avoir un accord avec un auteur, c'est sa parole. La plateforme ne publiera pas le livre de quelqu'un sur cette seule base : un titre soumis au nom d'un auteur est donc ingéré puis mis en attente — entièrement téléversé, totalement invisible, et en attente.

Il existe quatre façons pour l'auteur de donner son consentement.

  • Transfert. L'auteur clique sur un bouton sur le site du partenaire et est redirigé ici pour confirmer dans sa propre session, puis renvoyé. C'est la voie la plus rapide et la preuve la plus solide, car la confirmation est recueillie directement plutôt qu'affirmée.
  • Depuis le tableau de bord. Un auteur qui possède déjà un compte accepte depuis sa page de publication. Aucun e-mail n'est impliqué.
  • Lien de réclamation. Si l'auteur n'a pas de compte, un lien envoyé par e-mail explique ce qui a été soumis et lui demande d'accepter ou de refuser.
  • L'auteur demande. Un auteur peut demander à un partenaire répertorié de publier pour lui. C'est une autorisation, pas une instruction : le partenaire doit toujours soumettre, et la demande d'un auteur ne prévaut pas sur un éventuel contrat entre eux.

Lorsque l'auteur accepte, tout ce qui est en attente sous cette autorisation est publié immédiatement, dans les conditions déjà énoncées par le partenaire, et la propriété lui est transférée dans le même acte. L'autorisation est permanente ensuite, si bien que les titres suivants sont publiés immédiatement. L'auteur reçoit un e-mail à chaque publication.

Révocation

Un auteur peut retirer son autorisation à tout moment depuis sa page de publication. Le retrait bloque les soumissions futures. Il ne dépublie rien de déjà en ligne et n'interrompt pas les 10 % sur les titres apportés par le partenaire, car cette part enregistre qui a apporté le livre, non qui a actuellement le droit d'en envoyer d'autres.

La suppression de l'attribution sur un titre existant est possible, uniquement sur demande écrite de l'auteur. Elle est traitée manuellement et ne vaut que pour l'avenir : les gains déjà versés ne sont jamais recalculés.

Un auteur peut également refuser et bloquer, ce qui empêche un partenaire de le recontacter. L'adresse e-mail de l'auteur bloqué est conservée à cette seule fin.

Gestion des versions et ce que nous promettons de ne pas modifier

La version figure dans le chemin : /api/publish/v1/. Chaque réponse contient également un en-tête Novelmint-Publish-Version.

Dans la v1, nous pouvons ajouter des points de terminaison, des champs de requête facultatifs, des champs de réponse et de nouveaux codes d'erreur. Votre intégration doit ignorer tout ce qu'elle ne reconnaît pas — c'est cette seule exigence qui permet à la v1 d'évoluer sans vous impacter.

Supprimer un champ, le renommer, en changer le type ou modifier la signification d'une valeur existante constituerait une v2, sur un nouveau chemin. La v1 continue de fonctionner, et tout retrait serait annoncé par écrit avec un préavis, plutôt qu'impliqué par une hausse de numéro de version.

Limites pratiques

  • Les chapitres sont envoyés un par un, jusqu'à 1 Mo chacun. Il n'existe pas de point de terminaison pour l'envoi d'un livre entier.
  • L'ingestion est gratuite. Rien sur ce chemin ne débite de crédits.
  • Les couvertures sont récupérées depuis une URL HTTPS fournie lors de l'appel de publication, et sont examinées après publication, non avant.
  • Les jetons de test font tourner l'ensemble du pipeline sans aller jusqu'à la publication, ce qui permet de tester une intégration de bout en bout sans qu'un vrai titre n'atteigne les lecteurs.
  • Chaque réponse répercute la référence catalogue propre au partenaire, et chaque écriture est idempotente — un lot resoumis ne crée jamais de doublon.

Obtenir un jeton

Les partenaires de publication sont approuvés manuellement. Une fois approuvés, les jetons sont générés depuis l'onglet Jetons du tableau de bord partenaire. La référence complète des points de terminaison est publique et déjà disponible ici si vous souhaitez la consulter avant de vous décider. Postulez pour devenir partenaire, ou découvrez qui publie déjà ici.