how can I monitor metadata changes with API?

[WiiGe]

after searched Komga API for few hours, I can not find a proper way to monitor the modifications of specified series in KOMGA.

Did I miss anything?
Is it feasible by API?

Help pls

[gotson]

It depends what you mean by monitor.

Komga has a Server Sent Events endpoint (albeit not documented), which send events from the server to the subscriber when certain events happen, for example a series is added, updated or deleted. That would require an active connection to listen to the changes.

If you want to call the API at a later stage, say 1 day later, and see what has changed on a specific series, there is no such API that would provide what has changed. There is a last modified time on the objects though, which you can sort by.

[WiiGe]

thanks for your reply, FYI, I am trying to implement a function that can realtime percept the metadata change of specified series.

when any books were added to library of komga or a metadata was modified(e.g. title/author changed) by user, this function shall know those changes scope(e.g get a series list) in specified timespan (e.g. in 15 mins), then pass those series to proceeding process. therefore, I do not only care about the lastModifiedTime of a series, but also , I care about the metadata changes of series.

Komga has a Server Sent Events endpoint (albeit not documented)

I am interested in the Server Sent Events endpoint you talked about, is there any reading materials on this that I can utilize this endpoint in my code? tell me more about this pls

[gotson]

It's not documented, but it's used by the webui to react to realtime updates. You can check the client code in https://github.com/gotson/komga/blob/0a2c3ace2883b5c9d8be4b5235a5b0db107eba5e/komga-webui/src/services/komga-sse.service.ts

[WiiGe]

it's responsive and quick at http://localkomga/sse/v1/events :

Connection opened
Received: {"count":0,"countByType":{}}
Received: {"count":0,"countByType":{}}
Received: {"count":0,"countByType":{}}
Received: {"count":0,"countByType":{}}
Received: {"count":0,"countByType":{}}
Received: {"count":0,"countByType":{}}
Received: {"count":0,"countByType":{}}
Received: {"seriesId":"0JR3CFDZAGXZF","libraryId":"0JR3B78BEGVYG"}
Received: {"count":0,"countByType":{}}
Received: {"seriesId":"0JR3CFDZAGXZF","libraryId":"0JR3B78BEGVYG"}
Received: {"count":0,"countByType":{}}
Received: {"count":0,"countByType":{}}

thanks a lot !