jellybrick/koyo

Koyo: Unofficial HoyoLab & Genshin Impact API written in Kotlin

Koyo: Unofficial HoyoLab & Genshin Impact API written in Kotlin

Install (maven, gradle...etc)

Jitpack

allprojects {
  repositories {
		// ...
		maven { url 'https://jitpack.io' }
	}
}

dependencies {
    implementation 'com.github.JellyBrick:Koyo:$version'
}

How to obtain Genshin Wish API URL

Paimon.moe Document

How to obtain HoYoLab Cookie

HoyoLab-API Document

Special thanks to

• hoyolab-api
• Genshin-Impact-Wish-history-API
• genshinstats

koyo's Issues

Implement tests

with GitHub Actions

[Currently not implementable] generate gacha Authkey from HoyoLab sToken

Koyo/lib/src/main/kotlin/be/zvz/koyo/GenshinImpact.kt

Lines 421 to 498 in a9df521

	@OptIn(ExperimentalSerializationApi::class)
	fun authKey(): HoyoLabAuthKey {
	TODO(
	"Currently, oversea account (HoyoLab Account) is not support generate gacha Authkey from HoyoLab sToken. " +
	"Check this issue https://github.com/DGP-Studio/Snap.Hutao/issues/638 " +
	"I don't think it's technically impossible, but I haven't verified that it works. " +
	"https://github.com/ctrlcvs/xiaoyao-cvs-plugin/blob/master/model/mys/mihoyoApi.js"
	)
	val loginByCookieResult = okHttpClient.newCall(
	Request.Builder()
	.addHeader("User-Agent", Headers.Web.USER_AGENT)
	.addHeader("Cookie", RequestUtil.generateCookieFromCookieObject(cookie))
	.url(
	Routes.LOGIN_BY_COOKIE.toHttpUrl()
	.newBuilder()
	.addQueryParameter("t", Clock.System.now().epochSeconds.toString())
	.build(),
	)
	.get()
	.build(),
	).execute().use {
	jsonParser.decodeFromStream<HoyoLabWebResponse<HoyoLabLoginByCookie>>(it.body.byteStream()).data
	}
	val accountInfo =
	loginByCookieResult.accountInfo ?: throw HoyoLabException("Invalid data received ($loginByCookieResult)")
	val loginToken = okHttpClient.newCall(
	Request.Builder()
	.addHeader("User-Agent", Headers.Web.USER_AGENT)
	.addHeader("Cookie", RequestUtil.generateCookieFromCookieObject(cookie))
	.url(
	Routes.AUTH_MULTI_TOKEN.toHttpUrl()
	.newBuilder()
	.addQueryParameter("login_ticket", accountInfo.webLoginToken)
	.addQueryParameter("token_types", "3")
	.addQueryParameter("uid", accountInfo.accountId.toString())
	.build(),
	)
	.get()
	.build(),
	).execute().use {
	jsonParser.decodeFromStream<HoyoLabResponse<HoyoLabMultiTokenByLoginTicket>>(it.body.byteStream()).data
	}
	cookie.stuid = accountInfo.accountId
	val account = gamesList(Games.GENSHIN_IMPACT_GLOBAL).list.first { it.gameUid == uid }
	val ds = StringUtil.generateDS("jEpJb9rRARU2rXDA9qYbZ3selxkuct9a")
	val requestBuilder = RequestUtil.getDefaultAndroidRequestBuilder()
	.addHeader("DS", ds)
	.addHeader(
	"Cookie",
	RequestUtil.generateCookieFromCookieObject(cookie) + "; " + loginToken.list.joinToString("; ") { ticketToken ->
	"${ticketToken.name}=${ticketToken.token}"
	},
	)
	.url(Routes.GENSHIN_AUTHKEY)
	.post(
	jsonParser.encodeToString(
	HoyoLabAuthKeyRequest(
	"webview_gacha",
	account.gameBiz,
	account.gameUid,
	account.region,
	),
	).toRequestBody("application/json".toMediaType()),
	)
	val genshinAuthKeyResponse = okHttpClient.newCall(requestBuilder.build()).execute().use { response ->
	jsonParser.decodeFromStream<HoyoLabResponse<HoyoLabAuthKey?>>(response.body.byteStream())
	}
	return if (genshinAuthKeyResponse.message == "OK") {
	genshinAuthKeyResponse.data
	} else {
	null
	} ?: throw HoyoLabException("Invalid data received ($genshinAuthKeyResponse)")
	}

Currently, oversea account (HoyoLab Account) is not support generate gacha Authkey from HoyoLab sToken.
Check this issue DGP-Studio/Snap.Hutao#638
I don't think it's technically impossible, but I haven't verified that this (https://github.com/ctrlcvs/xiaoyao-cvs-plugin/blob/master/model/mys/mihoyoApi.js) works.

characters: Unexpected JSON token at offset 7

kotlinx.serialization.json.internal.JsonDecodingException: Unexpected JSON token at offset 7: Expected start of the object '{', but had ':' instead at path: $.data

JSON input

{"data":null,"message":"invalid request","retcode":-10001}

Dependency Dashboard

This issue lists Renovate updates and detected dependencies. Read the Dependency Dashboard docs to learn more.

Open

These updates have all been created already. Click a checkbox below to force a retry/rebase of any.

• chore(deps): update plugin org.jetbrains.kotlin.jvm to v1.9.24
• chore(deps): update plugin org.jetbrains.kotlin.plugin.serialization to v1.9.24
• fix(deps): update dependency com.benasher44:uuid to v0.8.4
• fix(deps): update dependency com.squareup.okhttp3:okhttp to v5.0.0-alpha.14
• chore(deps): update dependency gradle to v8.9
• fix(deps): update dependency org.jetbrains.kotlinx:kotlinx-datetime to v0.6.0
• fix(deps): update dependency org.jetbrains.kotlinx:kotlinx-serialization-json to v1.7.1
• chore(deps): update plugin org.jetbrains.kotlin.jvm to v2
• chore(deps): update plugin org.jetbrains.kotlin.plugin.serialization to v2
• Click on this checkbox to rebase all open PRs at once

Detected dependencies

gradle

gradle.properties

settings.gradle.kts

lib/build.gradle.kts

• org.jetbrains.kotlin.jvm 1.9.10
• org.jetbrains.kotlin.plugin.serialization 1.9.10
• com.squareup.okhttp3:okhttp 5.0.0-alpha.11
• org.jetbrains.kotlinx:kotlinx-datetime 0.4.0
• org.jetbrains.kotlinx:kotlinx-serialization-json 1.6.0
• com.soywiz.korlibs.krypto:krypto-jvm 4.0.10
• com.benasher44:uuid 0.8.1

gradle-wrapper

gradle/wrapper/gradle-wrapper.properties

• gradle 8.3

---

• Check this box to trigger a request for Renovate to run again on this repository

Genshin Impact: Wish History API

https://github.com/jvergerolle/Genshin-Impact-Wish-history-API