enkanetworkapigo

README

enka-network-api-go

API wrapper for https://enka.network/ in go

Requirements

I wrote it in go 1.21, will probably work with lower versions. idk It's all very straightforward usage, some examples can be found in the examples folder

Instalation

go get github.com/Fesaa/enka-network-api-go

Note

I stole the fields from the java version :D Feel free to message me on discord if needed ameliahh

I can't code, don't blame me thanks

Documentation

Index

• Constants
• Variables
• type EnkaNetworkAPI
  • func New(opts ...Option) (EnkaNetworkAPI, error)
• type GenshinAPI
• type HttpUserAgentInterceptor
  • func (uai *HttpUserAgentInterceptor) RoundTrip(request *http.Request) (*http.Response, error)
• type Option
  • func WithCustomUserAgent(userAgent string) Option
  • func WithHttpCache(cache cache.EnkaHttpCache) Option
  • func WithHttpClient(httpClient *http.Client) Option
  • func WithLogger(logger zerolog.Logger) Option
• type StarRailAPI

Constants

const BASE_GENSHIN_UI_URL = "https://enka.network/ui/"

const BASE_SR_UI_URL = "https://enka.network/ui/hsr/"

const BASE_URL = "https://enka.network/api/"

Variables

var MaintenanceError = errors.New("enka-network-api-go: The API is currently in maintenance")

Types

type EnkaNetworkAPI

type EnkaNetworkAPI interface {
	Data() data.EnkaData
	Cache() cache.EnkaHttpCache
	StarRail() StarRailAPI
	Genshin() GenshinAPI

	SetUserAgent(userAgent string)
	GetUserAgent() string
	HttpClient() *http.Client
}

func New

func New(opts ...Option) (EnkaNetworkAPI, error)

New creates a new EnkaNetworkAPI instance Will also initialize the cache and localization

From the documentation:

Please set a custom User-Agent header with your requests, so I can track them better and help you if needed.

See https://api.enka.network/ for API docs

type GenshinAPI

type GenshinAPI interface {
	Fetch(uid string, showCaseInfo bool, success utils.Consumer[*genshin.RawUser], failure utils.Consumer[error])
	FetchAndReturn(uid string, showCaseInfo bool) (*genshin.RawUser, error)

	CharacterData(userCharacter *genshin.UserCharacter) *genshin.CharacterData
	CharacterDataById(uuid string) *genshin.CharacterData

	Icon(key string) string

	ProfileId(id int) string
	NameCard(nameCardId int) *genshin.NameCard
	Material(id int) *genshin.RawMaterial
}

type HttpUserAgentInterceptor

type HttpUserAgentInterceptor struct {
	// contains filtered or unexported fields
}

func (*HttpUserAgentInterceptor) RoundTrip

func (uai *HttpUserAgentInterceptor) RoundTrip(request *http.Request) (*http.Response, error)

type Option

type Option func(e *enkaNetworkAPI)

func WithCustomUserAgent

func WithCustomUserAgent(userAgent string) Option

func WithHttpCache

func WithHttpCache(cache cache.EnkaHttpCache) Option

func WithHttpClient

func WithHttpClient(httpClient *http.Client) Option

func WithLogger

func WithLogger(logger zerolog.Logger) Option

type StarRailAPI

type StarRailAPI interface {
	Fetch(uid string, success utils.Consumer[*starrail.RawUser], failure utils.Consumer[error])
	FetchAndReturn(uid string) (*starrail.RawUser, error)

	CharacterData(userCharacter *starrail.UserCharacter) *starrail.CharacterData
	CharacterDataById(uuid string) *starrail.CharacterData

	RelicData(relic *starrail.Relic) *starrail.RelicData
	RelicDataById(relicId string) *starrail.RelicData

	LightConeData(lightCone *starrail.LightCone) *starrail.LightConeData
	LightConeDataById(lightConeId string) *starrail.LightConeData

	Icon(key string) string
	AvatarKey(avatarId string) string
}