Developer PSA: labs.j-novel.club is your new friend!

Ran

@chocolatkey Awesome, thanks! That's exactly what I needed. You were totally right about the enum name -- and I would never have figured out how to pass along the payment intent without seeing the protos laid out like that.

chocolatkey

Added a new GET https://labs.j-novel.club/app/v1/series/{ID or slug}/aggregate , to get all data regarding a series (series, volumes, parts). Should be identical to making the individual requests

chocolatkey

Added "status" to series, which can be (in JSON format) one of "DEFAULT", "COMPLETE", "HIATUS"

Bruhtek

Is it possible to get some pointers on the /parts/$slug/data endpoint? Light novel data is simple enough with /embed/$slug/data.xhtml, but doesn't work for manga. I am trying to get manga parts, but have no idea where to even start decoding the response.

chocolatkey

@Bartek The manga parts currently have DRM due to the stipulations of the original publisher(s). There is, therefore, no documentation on how to decode and display manga data

Bruhtek

@chocolatkey Ah, too bad!

TailsxKyuubi

My question is regarding the covers. is there any reason, that the field originalUrl is always empty? i would need the cover in a higher resolution.

chocolatkey

@TailsxKyuubi Because we don't actually have any original uploaded right now, it's planned for the future although I think that structure may change before then

TailsxKyuubi

@chocolatkey i dont understand the problem. they are already in some way uploaded. the ebooks itself already have the cover wouldnt it be possible to upload this in a automated process?

Bruhtek

Does the /auth/otp4app/check not accept format=json query? It works with /auth/otp4app/generate/, but for some reason not with the check one. From a decoder, all I can guess is that it returns some kind of token starting with otp_, and 3 numbers? Could we get some more info on how to login using the OTP code?

thelta

@Bartek
Yeah, I also couldn't manage to work with json. However, with protoc --decode_raw you can easily parse it. The protobuf format is probably something like this.

message Ttl
{
  int64 ttl_seconds = 1;
}
message AuthSession 
{
  string token = 1;
  Ttl ttl_seconds = 2;
  google.protobuf.Timestamp timestamp = 3;
}

Token size is 56 characters.

chocolatkey

@thelta @Bartek this is fixed, please try again

redmasq

For the heck of it, I decided to start going through the topic here and document the interface.

https://github.com/redmasq/jnc_swagger/blob/main/j-novel-club.swagger.yml
...~~the website https://editor.swagger.io/ can be used to view it.~~ I have setup a viewer on https://redmasq.github.io/jnc_swagger/

@chocolatkey if this effort is inappropriate for sharing, let me know and I'll private the repo and just keep it for my own purposes; however, in the meantime, I'm making my work available for others as I go along.

Just to note... It is a work-in-progress. So far, I've only done the initial login, but I will be expanding the document as I have time. As a programmer who likes to read isekai, I am hopelessly lazy and prefer studying and reading light novels over actually documenting... the effort is useful to me and I do like to spread the benefit; however, I'm not promising any timelines, update schedule, or anything of the like. I am willing to accept pull requests.

Bruhtek

@chocolatkey Can I ask You to add https://jnovel.bruhtek.com and (if possible *.jnovel.bruhtek.com) to CORS? I am working on a E-Ink optimized reader, and currently using my own cors proxy, but would prefer to be able to get rid of it as soon as possible (at least for the deployed version).
Thanks

Bruhtek

Also, are there any query parameters for /app/v1/series, except for the format and limit?. I am thinking about a way to only get follows / only catchups (since they're in the app), and if available, maybe also a way to sort the series A-Z, Z-A, release date/update date?

Edit:
Figured out follows and catchups, for anyone else you have to make a POST request, with body of

{
	"only_follows": true/false,
	"only_catchups": true/false
}

Still looking for a way to sort the results

pcj

@Bruhtek said in Developer PSA: labs.j-novel.club is your new friend!:

Still looking for a way to sort the results

sorting is easy to do client side.

Bruhtek

@pcj Then I would have to get all the series before sorting them, it is technically viable, but a way to get them already sorted to keep requests small (using pagination) would be even better

pcj

@Bruhtek True that. I didn't think about pagination, but if that's involved you definitely want a server side sort.

chocolatkey

@Bruhtek Added jnovel.bruhtek.com to the CORS exceptions, definitely nicer than proxying user data through your CORS proxy (please don't). It also includes localhost, 127.0.0.1 and dev.j-novel.club (nonexistent host you can map yourself) if you want to develop locally.

I thought I had documented sorting before, but here's the whole proto message for series querying:

/**
 * Search query for series
 */
message SeriesQuery {
    string query = 1; // Search query
    Series.Type type = 2; // The type of series to include

    Sorting sort = 3; // How to sort the series
    enum Sorting {
        NEWEST = 0; // Sort by created, descending
        OLDEST = 1; // Sort by created, ascending
        AZ = 2; // Sort by title, ascending
        ZA = 3; // Sort by title, descending
    }

    bool only_follows = 4;
    bool only_catchups = 5;
}

xellon

Hello, I'd like https://xellon.github.io to be included in CORS list. I'm making a pre-pub reader at https://xellon.github.io/pages/j-novel for my kindle paperwhite which has a very basic browser.