Publicando no Novelmint

Duas categorias são recusadas no momento da publicação, independentemente de quem as enviar ou do que diz o acordo com o escritor.

• Conteúdo adulto. Títulos classificados como Adulto são somente de manuscrito. Podem ser criados, editados e exportados, mas não podem ser listados ou vendidos. A classificação é por capítulo e se aplica ao livro como um todo, então um único capítulo pode tornar todo o título não publicável.
• Fan fiction. Obras baseadas em personagens de terceiros são somente de manuscrito por um critério separado. A plataforma não pode ser distribuidora dessas obras. Isso é uma questão de direitos, não de qualidade, e se aplica mesmo quando o escritor detém todos os direitos que poderia deter sobre seu próprio texto.

Ambos são retornados como códigos de motivo legíveis por máquina na chamada de publicação (manuscript_only, fan_fiction_manuscript_only), para que um catálogo de algumas centenas de títulos possa ser conciliado sem ler texto em inglês. Um terceiro código, derivative_unresolved, significa que a revisão de conteúdo sinalizou personagens que podem pertencer a outra obra e o escritor precisa resolver isso antes que o título possa ser publicado.

Livros publicados em nome de um escritor pertencem ao escritor. A conta dele é dona da série, os leitores o seguem, e os ganhos são dele. Isso não muda se o relacionamento com o parceiro terminar depois, e não é algo que um parceiro pode configurar.

Um parceiro que publica sob seu próprio selo é dono de seus títulos da forma convencional. Os dois modos são escolhidos por livro na criação, e o mecanismo de consentimento abaixo se aplica apenas ao primeiro.

• Os leitores pagam por capítulo. O escritor fica com 70% do que eles pagam.
• O Novelmint fica com 30%.
• Um parceiro ganha 10% de participação por indicação em cada título que trouxer. Essa parte sai dos 30% do Novelmint, nunca dos 70% do escritor. Aceitar um parceiro não custa nada ao escritor.

Os 10% são automáticos e por livro, o que significa que um escritor pode trazer livros de vários parceiros e cada parceiro ganha sobre os títulos que efetivamente trouxe. Não é preciso assinar nada nem fazer nenhuma configuração.

Um acordo de participação na receita é um instrumento diferente. Ele toma uma parte dos 70% do próprio escritor, é negociado e contrassinado pelo escritor, e não faz parte da API. Se um parceiro precisar de um, ele é feito manualmente.

Os ganhos do parceiro são retidos e pagos nos mesmos termos que os de um autor individual. Não há um cronograma separado para parceiros.

Um parceiro afirmar que tem um acordo com um escritor é palavra do parceiro. Publicar o livro de alguém com base apenas nisso não é algo que a plataforma fará, então um título enviado em nome de um escritor é recebido e mantido em espera: totalmente carregado, completamente invisível e aguardando.

Há quatro formas pelas quais o consentimento do próprio escritor chega.

• Handoff. O escritor clica em um botão no próprio site do parceiro e é redirecionado aqui para confirmar em sua própria sessão, sendo então enviado de volta. Este é o caminho mais rápido e a evidência mais sólida, pois a confirmação é coletada diretamente, não declarada.
• No painel. Um escritor que já tem uma conta aceita na sua página de publicação. Nenhum e-mail é envolvido.
• Link de reivindicação. Quando o escritor não tem conta, um link enviado por e-mail explica o que foi enviado e pede que ele aceite ou recuse.
• O escritor solicita. Um escritor pode pedir a um parceiro listado que publique por ele. Isso é uma permissão, não uma instrução: o parceiro ainda precisa enviar, e o pedido do escritor não anula qualquer contrato entre eles.

Quando o escritor aceita, tudo que estava retido sob essa permissão é publicado de uma vez, nos termos que o parceiro já havia declarado, e a propriedade passa para ele no mesmo ato. A permissão fica vigente depois disso, então títulos futuros são publicados imediatamente. O escritor é notificado por e-mail toda vez que isso acontece.

Um escritor pode retirar a permissão a qualquer momento, pela sua própria página de publicação. A retirada impede envios futuros. Ela não despublica nada que já esteja no ar e não interrompe os 10% sobre títulos que o parceiro trouxe, pois essa participação registra quem trouxe o livro, não quem tem permissão atualmente para enviar mais.

Remover a atribuição de um título existente é possível, e somente mediante solicitação por escrito do escritor. É feito manualmente e é apenas para frente: ganhos já pagos nunca são reescritos.

Um escritor também pode recusar e bloquear, o que impede um parceiro de entrar em contato com ele novamente. O endereço de e-mail do escritor bloqueado é retido apenas para essa finalidade.

A versão está no caminho: /api/publish/v1/. Cada resposta também traz um cabeçalho Novelmint-Publish-Version.

Dentro da v1, podemos adicionar endpoints, campos de requisição opcionais, campos de resposta e novos códigos de erro. Sua integração deve ignorar qualquer coisa que não reconheça, e esse único requisito é o que permite que a v1 evolua sem quebrar sua integração.

Remover um campo, renomeá-lo, mudar seu tipo ou alterar o significado de um valor existente seria uma v2, em um novo caminho. A v1 continua funcionando, e qualquer descontinuação seria anunciada por escrito com aviso prévio, em vez de ser indicada apenas por um número de versão maior.

• Capítulos são enviados um a um, com até 1 MB cada. Não há endpoint para o livro inteiro.
• A ingestão é gratuita. Nada neste caminho debita créditos.
• Capas são buscadas a partir de uma URL HTTPS fornecida na chamada de publicação e são revisadas após a publicação, não antes.
• Tokens de teste executam todo o pipeline e param antes da publicação, para que uma integração possa ser testada de ponta a ponta sem que um título real chegue aos leitores.
• Cada resposta repete a referência do próprio catálogo do parceiro, e cada escrita é idempotente, então um lote reenviado nunca duplica nada.