API to get gift codes from Hoyoverse games, made for auto code redemption feature in hoyo buddy.
- Genshin: https://hoyo-codes.seria.moe/codes?game=genshin
- Honkai Star Rail: https://hoyo-codes.seria.moe/codes?game=hkrpg
- Honkai Impact 3rd: https://hoyo-codes.seria.moe/codes?game=honkai3rd
- Zenless Zone Zero: https://hoyo-codes.seria.moe/codes?game=nap
- Tears of Themis: https://hoyo-codes.seria.moe/codes?game=tot
- The
run.pyfile is responsible for running the API - The
update.pyfile is used to fetch codes from the sources listed in/api/codes/sources.py - The
check.pyfile is used to check the status of old codes to see if they have expired
- We first use
aiohttpto get the website's HTML. For pockettactics you would need a user agent, else the website blocks you, this is why thefake-useragentpackage is used - Then we parse the HTML using
beautifulsoup+lxml(for faster parsing), then extract the codes from the website by inspecting the HTML elements - Next we verify the status of the each code with
genshin.py, we would request to HoYoLAB to redeem a specific code, and save the code with differentCodeStatus(OK or NOT_OK) based on the redemption result. If the code already exists in the database, we would skip the verification process
- We get all the codes in the database with
CodeStatus.OKand verify their status with the same technique used inupdate.py - Update the code with the new status
The API grabs the codes from the database with CodeStatus.OK and game with the game requested
The API runs on my machine, and I schedule 2 tasks:
update.pyto run once every 2 hourscheck.pyto run once everyday
Honkai Impact 3rd and Tears of Themis code status cannot be verified. For Hi3, codes can't be redeemed on the website, and for ToT, I don't have a game account for it. The status of codes for these two games will always be CodeStatus.OK.
For CN region, they can only redeem codes in-game, so this service is not possible for them.
![@renovate[bot]](https://avatars.githubusercontent.com/in/2740?s=64&v=4){kind=small}