https://github.com/axt-team/uapi-sdk-go
UAPI 的 Go SDK
https://github.com/axt-team/uapi-sdk-go
api-client golang sdk uapi
Last synced: about 2 months ago
JSON representation
UAPI 的 Go SDK
- Host: GitHub
- URL: https://github.com/axt-team/uapi-sdk-go
- Owner: AxT-Team
- Created: 2025-11-10T10:01:26.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-02-26T09:26:53.000Z (3 months ago)
- Last Synced: 2026-02-26T15:10:17.884Z (3 months ago)
- Topics: api-client, golang, sdk, uapi
- Language: Go
- Size: 3.39 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# uapi-sdk-go
[](https://go.dev/)
[](https://uapis.cn/)
[](https://pkg.go.dev/github.com/AxT-Team/uapi-sdk-go)
> [!NOTE]
> 所有接口的 Go 示例都可以在 [UApi](https://uapis.cn/docs/introduction) 的接口文档页面，向下滚动至 **快速启动** 区块后直接复制。
## 快速开始
```bash
go get github.com/AxT-Team/uapi-sdk-go@latest
```
```go
package main
import (
"fmt"
"github.com/AxT-Team/uapi-sdk-go/uapi"
)
func main() {
client := uapi.New("https://uapis.cn", "YOUR_API_KEY")
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文档首页](https://uapis.cn/docs/introduction) 并选择任意接口，向下滚动到 **快速启动** 区块即可看到最新的 Go 示例代码。