uapi-sdk-go

Note

所有接口的 Go 示例都可以在 UApi 的接口文档页面，向下滚动至 快速启动 区块后直接复制。

快速开始

go get github.com/AxT-Team/uapi-sdk-go@latest

package main

import (
	"fmt"
	"github.com/AxT-Team/uapi-sdk-go/uapi"
)

func main() {
	client := uapi.New("https://uapis.cn/api/v1", "")
	info, err := client.Social().GetSocialQqUserinfo(map[string]any{"qq": "10001"})
	if err != nil {
		panic(err)
	}
	fmt.Println(info)
}

特性

现在你不再需要反反复复的查阅文档了。

只需在 IDE 中键入 client.，所有核心模块——如 Social()、Game()、Image()——即刻同步展现。进一步输入即可直接定位到 GetSocialQqUserinfo（获取 QQ 用户信息） 这样的具体方法，其名称与文档的 operationId 严格保持一致，确保了开发过程的直观与高效。

所有方法签名只接受真实且必需的参数。当你在构建请求时，IDE 会即时提示 qq、username 等键名，这彻底杜绝了在 map[string]any 中因键名拼写错误而导致的运行时错误。

针对 401、404、429 等标准 HTTP 响应，SDK 已将其统一映射为具名的错误类型。这些错误均附带 status、request_id、retry_after_seconds 等关键上下文信息，确保你在日志中能第一时间准确、快速地诊断问题。

基础域名、请求超时和 User-Agent 已预设为合理的默认值。但你完全拥有控制权，可以通过 uapi.Client.Builder() 模式灵活覆盖 Token、BaseURL 等配置。

如果你需要查看字段细节或内部逻辑，仓库中的 ./internal 目录同步保留了由 openapi-generator 生成的完整结构体，随时可供参考。

错误模型概览

HTTP 状态码	SDK 错误类型	附加信息
401/403	AuthenticationError	status、request_id
404	NotFound	status、request_id
400	ValidationError	status、request_id、details（如缺少参数、格式错误）
429	RateLimitError	status、request_id、retry_after_seconds（用于决定何时重试）
5xx	ServerError	status、request_id
其他 4xx	ApiError	status、request_id、code、message、details（用于快速定位具体业务错误）

其他 SDK

语言	仓库地址
Go（当前）	https://github.com/AxT-Team/uapi-sdk-go
Python	https://github.com/AxT-Team/uapi-sdk-python
TypeScript	https://github.com/AxT-Team/uapi-sdk-typescript
Browser (TypeScript/JavaScript)	https://github.com/AxT-Team/uapi-browser-sdk
Java	https://github.com/AxT-Team/uapi-sdk-java
PHP	https://github.com/AxT-Team/uapi-sdk-php
C#	https://github.com/AxT-Team/uapi-sdk-csharp
C++	https://github.com/AxT-Team/uapi-sdk-cpp
Rust	https://github.com/AxT-Team/uapi-sdk-rust

文档

访问 UApi文档首页 并选择任意接口，向下滚动到 快速启动 区块即可看到最新的 Go 示例代码。