Publikowanie na Novelmint
API wydawnicze przyjmuje gotowy manuskrypt i udostępnia go czytelnikom. Partner tworzy książkę, przesyła rozdziały jeden po drugim, dodaje okładkę, a następnie publikuje. Wszystko poniżej to zasady, które decydują o powodzeniu tego ostatniego kroku — warto je przeczytać przed napisaniem jakiegokolwiek kodu.
Co nie może być tu publikowane
Dwie kategorie są odrzucane na etapie publikacji — niezależnie od tego, kto je przesyła i co stanowi umowa z autorem.
- Treści dla dorosłych. Tytuły sklasyfikowane jako dla dorosłych są dostępne wyłącznie jako manuskrypty. Można je tworzyć, edytować i eksportować, ale nie można ich wystawiać ani sprzedawać. Klasyfikacja jest przypisywana na poziomie rozdziału i dotyczy całej książki — jeden rozdział może uniemożliwić publikację całego tytułu.
- Fan fiction. Prace oparte na postaciach należących do kogoś innego są dostępne wyłącznie jako manuskrypty — na odrębnych zasadach. Platforma nie może być ich dystrybutorem. Chodzi o prawa, a nie o jakość — dotyczy to nawet sytuacji, gdy autor posiada wszelkie prawa, jakie może posiadać do własnego tekstu.
Oba przypadki są zwracane jako kody błędów w wywołaniu publikacji (manuscript_only, fan_fiction_manuscript_only), dzięki czemu katalog kilkuset tytułów można uzgodnić bez czytania opisów. Trzeci kod, derivative_unresolved, oznacza, że weryfikacja treści wykryła postacie mogące należeć do innego dzieła — autor musi to rozstrzygnąć przed publikacją tytułu.
Kto jest właścicielem treści
Książki opublikowane w imieniu autora należą do autora. Jego konto jest właścicielem serii, czytelnicy go obserwują, a zarobki należą do niego. Nie zmienia się to po ewentualnym zakończeniu współpracy z partnerem i partner nie może tego konfigurować.
Partner publikujący pod własnym szyldem jest właścicielem swoich tytułów w zwykły sposób. Oba tryby są wybierane dla każdej książki przy jej tworzeniu, a mechanizm zgody opisany poniżej dotyczy wyłącznie pierwszego z nich.
Jak działają płatności
- Czytelnicy płacą za rozdział. Autor zachowuje 70% wpłaconych środków.
- Novelmint zatrzymuje 30%.
- Partner otrzymuje 10% z każdego tytułu, który tu przysłał. Ten udział pochodzi z 30% Novelmint — nigdy z 70% autora. Przyjęcie partnera nie kosztuje autora nic.
10% jest naliczane automatycznie dla każdej książki z osobna, co oznacza, że jeden autor może przysyłać książki od kilku partnerów, a każdy z nich zarabia tylko na tytułach, które faktycznie przysłał. Nie wymaga to żadnych podpisów ani konfiguracji.
Umowa o podziale przychodów to odrębny instrument. Pobiera część z 70% autora, jest negocjowana i podpisywana przez autora — i nie jest częścią API. Jeśli partner jej potrzebuje, jest zawierana ręcznie.
Zarobki partnerów są przechowywane i wypłacane na tych samych zasadach co zarobki indywidualnych autorów. Nie ma osobnego harmonogramu dla partnerów.
Zgoda i jej cel
Twierdzenie partnera, że ma umowę z autorem, jest jedynie słowem partnera. Platforma nie opublikuje czyjejś książki wyłącznie na tej podstawie — dlatego tytuł przesłany w imieniu autora jest wgrywany, a następnie wstrzymywany: w pełni przesłany, całkowicie niewidoczny i oczekujący.
Są cztery sposoby, w jakie autor może wyrazić własną zgodę.
- Przekierowanie. Autor klika przycisk na stronie partnera i jest przekierowywany tutaj, aby potwierdzić we własnej sesji, a następnie wraca. To najszybsza droga i najsilniejszy dowód — potwierdzenie jest zbierane bezpośrednio, a nie deklarowane.
- Panel wydawniczy. Autor posiadający już konto akceptuje na swojej stronie wydawniczej. Nie wymaga to e-maila.
- Link aktywacyjny. Jeśli autor nie ma konta, link wysłany e-mailem wyjaśnia, co zostało przesłane, i prosi o akceptację lub odrzucenie.
- Prośba autora. Autor może poprosić zarejestrowanego partnera o publikację w jego imieniu. To zezwolenie, nie polecenie — partner nadal musi przesłać książkę, a prośba autora nie zastępuje żadnej umowy między nimi.
Gdy autor wyrazi zgodę, wszystko wstrzymane w ramach tego zezwolenia zostaje opublikowane jednocześnie, na warunkach już wskazanych przez partnera, a własność przechodzi na autora w tym samym momencie. Od tej chwili zgoda jest trwała, więc kolejne tytuły są publikowane natychmiast. Autor otrzymuje powiadomienie e-mail za każdym razem, gdy tak się dzieje.
Cofnięcie zgody
Autor może wycofać zgodę w dowolnym momencie, z poziomu swojej strony wydawniczej. Cofnięcie zgody zatrzymuje przyszłe przesyłki. Nie powoduje odpublikowania treści już opublikowanych i nie wstrzymuje 10% od tytułów przysłanych przez partnera — ten udział rejestruje, kto przyniósł książkę, a nie kto aktualnie ma prawo przysyłać kolejne.
Usunięcie atrybucji z istniejącego tytułu jest możliwe wyłącznie na pisemny wniosek autora. Odbywa się ręcznie i dotyczy tylko przyszłości — zarobki już wypłacone nie są nigdy cofane.
Autor może również odrzucić zgłoszenie i zablokować partnera, co uniemożliwia mu ponowny kontakt. Adres e-mail zablokowanego autora jest przechowywany wyłącznie w tym celu.
Wersjonowanie i co zobowiązujemy się nie zmieniać
Wersja jest zawarta w ścieżce: /api/publish/v1/. Każda odpowiedź zawiera również nagłówek Novelmint-Publish-Version.
W ramach v1 możemy dodawać endpointy, opcjonalne pola żądań, pola odpowiedzi i nowe kody błędów. Twoja integracja musi ignorować wszystko, czego nie rozpoznaje — to jedyny wymóg, który pozwala v1 się rozwijać bez zrywania zgodności.
Usunięcie pola, zmiana jego nazwy, typu lub znaczenia istniejącej wartości oznaczałoby v2 na nowej ścieżce. v1 pozostaje aktywna, a każde wycofanie byłoby zapowiedziane z wyprzedzeniem na piśmie — nie sugerowane przez zmianę numeru wersji.
Praktyczne limity
- Rozdziały są przesyłane pojedynczo, do 1 MB każdy. Nie ma endpointu dla całej książki.
- Przesyłanie jest bezpłatne. Ta ścieżka nie pobiera żadnych kredytów.
- Okładki są pobierane z adresu URL HTTPS podanego w wywołaniu publikacji i weryfikowane po publikacji, a nie przed.
- Tokeny testowe uruchamiają cały potok i zatrzymują się tuż przed publikacją, dzięki czemu integrację można przetestować od początku do końca bez docierania prawdziwego tytułu do czytelników.
- Każda odpowiedź zawiera własny identyfikator katalogu partnera, a każdy zapis jest idempotentny — ponownie wysłana partia nigdy niczego nie zduplikuje.
Jak uzyskać token
Partnerzy wydawniczy są zatwierdzani ręcznie. Po zatwierdzeniu tokeny są generowane z zakładki Tokeny w panelu partnera. Pełna dokumentacja endpointów jest publiczna i dostępna już tutaj, jeśli chcesz ją przejrzeć przed podjęciem decyzji. Aplikuj, aby zostać partnerem lub sprawdź, kto już tu publikuje.