Xuất bản lên Novelmint
API xuất bản nhận bản thảo hoàn chỉnh và đưa nó đến tay độc giả. Đối tác tạo một cuốn sách, đăng từng chương một, đính kèm bìa rồi xuất bản. Mọi nội dung dưới đây là quy tắc quyết định liệu bước cuối cùng đó có thành công không, vì vậy hãy đọc trước khi viết bất kỳ đoạn code nào.
Những gì không thể xuất bản ở đây
Hai danh mục bị từ chối tại thời điểm xuất bản, bất kể ai gửi và bất kể thỏa thuận với tác giả là gì.
- Nội dung người lớn. Các tựa được phân loại là Người lớn chỉ dành cho bản thảo. Chúng có thể được tạo, chỉnh sửa và xuất khẩu, nhưng không thể được niêm yết hoặc bán. Phân loại theo từng chương và áp dụng lên toàn bộ sách, do đó một chương duy nhất có thể khiến cả tựa sách không thể xuất bản.
- Fan fiction. Tác phẩm dựa trên nhân vật thuộc về người khác chỉ dành cho bản thảo theo một trục riêng biệt. Nền tảng không thể làm nhà phân phối cho loại này. Đây là vấn đề về bản quyền chứ không phải chất lượng, và áp dụng ngay cả khi tác giả nắm giữ mọi quyền có thể có trong văn bản của họ.
Cả hai đều được trả về dưới dạng mã lý do có thể đọc được bằng máy trong lệnh publish (manuscript_only, fan_fiction_manuscript_only), do đó một danh mục vài trăm tựa sách có thể được đối chiếu mà không cần đọc văn xuôi. Mã thứ ba, derivative_unresolved, có nghĩa là kiểm duyệt nội dung đã gắn cờ các nhân vật có thể thuộc tác phẩm khác và tác giả phải giải quyết trước khi tựa sách có thể phát hành.
Ai sở hữu tác phẩm
Sách xuất bản thay mặt tác giả thuộc về tác giả. Tài khoản của họ sở hữu series, độc giả theo dõi họ và thu nhập là của họ. Điều đó không thay đổi nếu mối quan hệ với đối tác kết thúc sau này, và đây không phải điều đối tác có thể cấu hình.
Đối tác xuất bản dưới thương hiệu riêng sở hữu tựa sách của mình theo cách thông thường. Hai chế độ được chọn theo từng cuốn sách khi tạo, và cơ chế đồng ý bên dưới chỉ áp dụng cho chế độ đầu tiên.
Cách thức hoạt động của tiền
- Độc giả trả tiền theo chương. Tác giả giữ 70% số tiền họ trả.
- Novelmint giữ 30%.
- Đối tác nhận 10% phần giới thiệu trên mỗi tựa sách họ đưa vào đây. Phần đó được lấy từ 30% của Novelmint, không bao giờ lấy từ 70% của tác giả. Chấp nhận một đối tác không tốn gì của tác giả.
10% là tự động và theo từng cuốn sách, nghĩa là một tác giả có thể mang sách từ nhiều đối tác và mỗi đối tác nhận phần trên những tựa họ thực sự đưa vào. Không cần ký kết gì, không cần cấu hình gì thêm.
Thỏa thuận chia sẻ doanh thu là một công cụ khác. Nó lấy một phần từ 70% của tác giả, được đàm phán và ký kết bởi tác giả, và không phải là một phần của API. Nếu đối tác cần thỏa thuận đó, phải được sắp xếp thủ công.
Thu nhập của đối tác được giữ và thanh toán theo cùng điều khoản như tác giả cá nhân. Không có lịch thanh toán riêng cho đối tác.
Đồng ý và mục đích của nó
Đối tác khẳng định có thỏa thuận với tác giả chỉ là lời nói của đối tác. Nền tảng sẽ không xuất bản sách của ai đó chỉ dựa trên điều đó, vì vậy tựa sách được gửi thay mặt tác giả sẽ được nhận và giữ lại: đã tải lên hoàn toàn, hoàn toàn ẩn và đang chờ.
Có bốn cách để nhận được sự đồng ý trực tiếp từ tác giả.
- Chuyển giao. Tác giả nhấp vào nút trên trang của đối tác và được chuyển hướng đến đây để xác nhận trong phiên của họ, sau đó được gửi trở lại. Đây là con đường nhanh nhất và bằng chứng mạnh nhất, vì xác nhận được thu thập trực tiếp chứ không phải khẳng định.
- Trên bảng điều khiển. Tác giả đã có tài khoản chấp nhận trên trang xuất bản của họ. Không cần email.
- Liên kết xác nhận. Với tác giả chưa có tài khoản, một liên kết qua email giải thích những gì đã được gửi và yêu cầu họ chấp nhận hoặc từ chối.
- Tác giả yêu cầu. Tác giả có thể yêu cầu một đối tác đã được liệt kê xuất bản thay cho họ. Đó là sự cho phép, không phải chỉ thị: đối tác vẫn phải gửi, và yêu cầu của tác giả không ghi đè bất kỳ hợp đồng nào giữa họ.
Khi tác giả chấp nhận, mọi thứ được giữ dưới quyền đó sẽ được xuất bản cùng lúc, theo các điều khoản đối tác đã nêu, và quyền sở hữu chuyển sang họ trong cùng hành động đó. Sau đó quyền trở thành thường trực, nên các tựa sách sau sẽ xuất bản ngay. Tác giả sẽ nhận email mỗi khi điều đó xảy ra.
Thu hồi quyền
Tác giả có thể rút quyền bất cứ lúc nào, từ trang xuất bản của họ. Việc rút quyền dừng các lần gửi trong tương lai. Nó không gỡ xuất bản bất kỳ nội dung nào đã phát hành, và không dừng 10% trên các tựa đối tác đã đưa vào, vì phần đó ghi lại ai đã đưa sách vào chứ không phải ai hiện có quyền gửi thêm.
Việc xóa quy gán trên một tựa sách đã có là có thể, và chỉ theo yêu cầu bằng văn bản của tác giả. Được xử lý thủ công và chỉ áp dụng về phía trước: thu nhập đã thanh toán không bao giờ bị ghi lại.
Tác giả cũng có thể từ chối và chặn, điều này ngăn đối tác liên hệ với họ nữa. Địa chỉ email của tác giả bị chặn chỉ được lưu giữ cho mục đích đó.
Versioning và những gì chúng tôi cam kết không thay đổi
Phiên bản nằm trong đường dẫn: /api/publish/v1/. Mỗi phản hồi cũng mang header Novelmint-Publish-Version.
Trong v1, chúng tôi có thể thêm endpoint, trường yêu cầu tùy chọn, trường phản hồi và mã lỗi mới. Tích hợp của bạn phải bỏ qua bất kỳ điều gì nó không nhận ra, và yêu cầu duy nhất đó cho phép v1 cải tiến mà không làm hỏng tích hợp của bạn.
Xóa một trường, đổi tên, thay đổi kiểu hoặc thay đổi ý nghĩa của một giá trị hiện có sẽ là v2, trên một đường dẫn mới. v1 tiếp tục hoạt động, và bất kỳ việc ngừng sử dụng nào sẽ được thông báo bằng văn bản trước, không phải ngụ ý bởi việc số phiên bản tăng lên.
Giới hạn thực tế
- Các chương được đăng từng cái một, tối đa 1 MB mỗi chương. Không có endpoint cho toàn bộ cuốn sách.
- Nhập dữ liệu miễn phí. Không có gì trên đường dẫn này trừ credit.
- Bìa sách được lấy từ URL HTTPS cung cấp trong lệnh publish, và được xem xét sau khi xuất bản chứ không phải trước.
- Token thử nghiệm chạy toàn bộ quy trình và dừng trước bước xuất bản, để tích hợp có thể được kiểm tra từ đầu đến cuối mà không có tựa sách thật nào đến tay độc giả.
- Mỗi phản hồi đều phản chiếu tham chiếu danh mục riêng của đối tác, và mỗi lần ghi là idempotent, vì vậy một lô được thử lại không bao giờ tạo ra bản trùng lặp.
Lấy token
Đối tác xuất bản được duyệt thủ công. Sau khi được duyệt, token được tạo từ tab Tokens trên bảng điều khiển đối tác. Tài liệu tham khảo endpoint đầy đủ là công khai và đã có ở đây nếu bạn muốn đọc trước khi quyết định. Đăng ký trở thành đối tác, hoặc xem ai đã xuất bản ở đây.