https://github.com/nota30/genshingo

A simple wrapper to fetch user data from Genshin Impact.
https://github.com/nota30/genshingo

api genshin genshin-api genshin-impact go golang hoyolab hoyoverse

Last synced: about 2 months ago
JSON representation

A simple wrapper to fetch user data from Genshin Impact.

• Host: GitHub
• URL: https://github.com/nota30/genshingo
• Owner: Nota30
• License: mit
• Created: 2022-08-03T12:16:37.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2023-06-12T21:45:57.000Z (over 1 year ago)
• Last Synced: 2024-06-21T04:24:47.056Z (7 months ago)
• Topics: api, genshin, genshin-api, genshin-impact, go, golang, hoyolab, hoyoverse
• Language: Go
• Homepage:
• Size: 20.5 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Genshingo

An API wrapper to fetch your genshin user data!

- You can also fetch all your characters data (name, level, constellation, etc)

## Prerequisites

- [Go](https://go.dev/)

- HoyoLab Cookies - You can get you hoyolab cookies by visiting [hoyolab](https://www.hoyolab.com/) and logging in. After you login `Ctrl + Shift + I` then click on the `Console` Tab and then type `document.cookie` and thats the cookie!

## Install

You can run the test file to run this in the command line. You can compile it and run it your self `test/test.go` or install one of the [releases](https://github.com/Nota30/genshingo/releases). **Note:** You need to go install before you run.

**The default test file looks like this:**

![image](https://user-images.githubusercontent.com/60175653/234162511-998ccaa0-187f-46ba-bfa2-1683814f2a87.png)

 

## Quick Start

Import the `genshingo` package first.

```go

package main

import (

	genshin "github.com/Nota30/genshingo"

)

func main() {

	init := genshin.Init{

		Cookie: "cookie goes here",

		Server: "os",

	}

	user, err := init.GetUserData("uid")

	if err != nil {

		println(err)

	}

	println(user.Data.Info.Nickname)

}

```

## Issues

- If you don't get a users data that means they haven't set their profile to `public` in hoyolab. You can make it public by going to hoyolab settings.

- Currently only works with the `os` servers so the `cn` servers won't work. Will be added in a later release maybe?