This package implements almost all of the endpoints required to create and manage contributions on TheDiscDB. As these are mostly authenticated endpoints, you will have to populate options.cookies when initializing the client with a cookie string for the site. I haven't done any reverse engineering per authorization, so it'll just be easier to copy the entire Cookie value from your browser. TheDiscDB uses session expiry for its cookies, but they may have an additional validity window internally.
Lifecycle of a contribution:
- Select media type of the release (MediaItemType)
- Search for the media to obtain its TMDB ID: externalSearch
- Obtain or generate an
uploaderId UUID (unknown)
- Upload front image (required) and back image (optional): uploadTemporalContributionImage
- Create the release with its details: TMDB ID and uploaded image details -> createContribution -> returns contribution ID
- Add a disc:
- Hash the disc: contribution ID and files -> hash -> returns hash
- Create the disc with its details: contribution ID and hash -> createDisc -> returns encoded ID
- Upload MakeMKV logs for the disc: contribution ID and disc ID -> uploadDiscLogs
- Identify items: contribution ID and disc ID -> addItemToDisc
- Submit for review: discdbapi cannot do this currently. You will need to manually visit
https://thediscdb.com/contribution/{contributionId}/review and click "Submit for Review"