Publicar en Novelmint

La API de publicación toma un manuscrito terminado y lo pone ante los lectores. Un socio crea un libro, sube sus capítulos uno a uno, adjunta una portada y lo publica. Todo lo que sigue es una regla que determina si ese último paso tiene éxito, por lo que vale la pena leerlo antes de escribir código.

Qué no se puede publicar aquí

Dos categorías se rechazan en el momento de publicar, independientemente de quién las envíe o del acuerdo con el escritor.

  • Contenido para adultos. Los títulos clasificados como Adulto son solo de manuscrito. Pueden crearse, editarse y exportarse, pero no pueden listarse ni venderse. La clasificación es por capítulo y se propaga al libro, por lo que un solo capítulo puede hacer que todo el título sea impublicable.
  • Fan fiction. Las obras basadas en personajes que pertenecen a terceros son solo de manuscrito en un eje separado. La plataforma no puede ser su distribuidora. Esto tiene que ver con los derechos, no con la calidad, y aplica incluso cuando el escritor posee todos los derechos que podría poseer sobre su propio texto.

Ambas se devuelven como códigos de motivo legibles por máquina en la llamada de publicación (manuscript_only, fan_fiction_manuscript_only), por lo que un catálogo de varios cientos de títulos puede reconciliarse sin leer texto en inglés. Un tercer código, derivative_unresolved, significa que la revisión de contenido ha detectado personajes que podrían pertenecer a otra obra y el escritor debe resolverlo antes de que el título pueda publicarse.

A quién pertenece la obra

Los libros publicados en nombre de un escritor pertenecen al escritor. Su cuenta es dueña de la serie, los lectores le siguen a él, y las ganancias son suyas. Eso no cambia si la relación con el socio termina más adelante, y no es algo que un socio pueda configurar.

Un socio que publica bajo su propio sello es dueño de sus títulos de la manera habitual. Ambos modos se eligen por libro en el momento de su creación, y el mecanismo de consentimiento descrito a continuación solo aplica al primero.

Cómo funciona el dinero

  • Los lectores pagan por capítulo. El escritor se queda con el 70% de lo que pagan.
  • Novelmint se queda con el 30%.
  • Un socio gana un 10% de referido por cada título que trajo aquí. Esa parte sale del 30% de Novelmint, nunca del 70% del escritor. Tener un socio no le cuesta nada al escritor.

El 10% es automático y por libro, lo que significa que un escritor puede traer libros de varios socios y cada socio gana sobre los títulos que él aportó. No hay nada que firmar ni que configurar.

Un acuerdo de reparto de ingresos es un instrumento distinto. Toma una parte del propio 70% del escritor, lo negocia y firma el escritor, y no forma parte de la API. Si un socio lo necesita, se gestiona de forma manual.

Las ganancias del socio se retienen y pagan en los mismos términos que las de un autor individual. No existe un calendario separado para socios.

El consentimiento y para qué sirve

Que un socio afirme tener un acuerdo con un escritor es solo su palabra. La plataforma no publicará el libro de alguien únicamente sobre esa base, por lo que un título enviado en nombre de un escritor se ingesta y luego se retiene: completamente subido, totalmente invisible y en espera.

Hay cuatro formas en que llega el consentimiento del propio escritor.

  • Transferencia directa. El escritor hace clic en un botón en el sitio del socio y es redirigido aquí para confirmar en su propia sesión, y luego enviado de vuelta. Es la vía más rápida y la evidencia más sólida, ya que la confirmación se recoge de primera mano en lugar de ser declarada.
  • Desde el panel. Un escritor que ya tiene cuenta acepta desde su página de publicación. No interviene ningún correo electrónico.
  • Enlace de reclamación. Si el escritor no tiene cuenta, un enlace enviado por correo le explica lo que se ha enviado y le pide que acepte o rechace.
  • El escritor solicita. Un escritor puede pedirle a un socio listado que publique por él. Eso es un permiso, no una instrucción: el socio igualmente debe enviar, y la petición del escritor no reemplaza ningún contrato entre ellos.

Cuando el escritor acepta, todo lo retenido bajo ese permiso se publica de inmediato, en los términos que el socio ya indicó, y la propiedad pasa al escritor en el mismo acto. El permiso queda vigente a partir de ese momento, por lo que los títulos posteriores se publican de inmediato. El escritor recibe un correo cada vez que eso ocurre.

Revocación

Un escritor puede retirar el permiso en cualquier momento desde su página de publicación. La revocación detiene futuros envíos. No despublica nada que ya esté activo, ni detiene el 10% sobre los títulos que el socio aportó, ya que esa parte registra quién trajo el libro y no quién tiene permiso actualmente para enviar más.

Eliminar la atribución en un título existente es posible, y solo a petición escrita del escritor. Se gestiona manualmente y aplica solo hacia adelante: las ganancias ya pagadas nunca se reescriben.

Un escritor también puede rechazar y bloquear, lo que impide que un socio vuelva a contactarle. La dirección de correo del escritor bloqueado se conserva únicamente con ese fin.

Versiones y lo que nos comprometemos a no romper

La versión está en la ruta: /api/publish/v1/. Cada respuesta también incluye un encabezado Novelmint-Publish-Version.

Dentro de v1 podemos añadir endpoints, campos de solicitud opcionales, campos de respuesta y nuevos códigos de error. Tu integración debe ignorar cualquier cosa que no reconozca, y ese único requisito es lo que permite que v1 mejore sin romperse.

Eliminar un campo, renombrarlo, cambiar su tipo o modificar el significado de un valor existente sería una v2, en una nueva ruta. v1 seguirá funcionando, y cualquier retirada se anunciaría por escrito con aviso previo, en lugar de quedar implícita por un número de versión mayor.

Límites prácticos

  • Los capítulos se envían de uno en uno, hasta 1 MB cada uno. No existe un endpoint para el libro completo.
  • La ingesta es gratuita. Nada en este flujo descuenta créditos.
  • Las portadas se obtienen desde una URL HTTPS proporcionada en la llamada de publicación y se revisan después de la publicación, no antes.
  • Los tokens de prueba ejecutan todo el proceso y se detienen antes de publicar, por lo que una integración puede probarse de extremo a extremo sin que ningún título real llegue a los lectores.
  • Cada respuesta incluye la referencia del catálogo propio del socio, y cada escritura es idempotente, por lo que un lote reintentado nunca duplica nada.

Obtener un token

Los socios editores son aprobados manualmente. Una vez aprobados, los tokens se generan desde la pestaña Tokens del panel de socios. La referencia completa de endpoints es pública y ya está disponible aquí si quieres leerla antes de decidir. Solicita convertirte en socio o descubre quién ya publica aquí.