chore: initial import

Author: AxT-Team Bot

.editorconfig

@@ -0,0 +1,6 @@
+root = true
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true

.github/workflows/release.yml

@@ -0,0 +1,10 @@
+name: release
+on:
+  push:
+    tags: ['v*.*.*']
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - run: echo "Release placeholder - customize per registry"

.github/workflows/test.yml

@@ -0,0 +1,10 @@
+name: test
+on: [push, pull_request]
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-go@v5
+        with: { go-version: '1.22' }
+      - run: go build ./...

.gitignore

@@ -0,0 +1,3 @@
+bin/
+dist/
+*.log

README.md

@@ -0,0 +1,76 @@
+# uapi-sdk-go
+
+![Banner](./banner.png)
+
+[![Go](https://img.shields.io/badge/Go-1.22+-00ADD8?style=flat-square&logo=go&logoColor=white)](https://go.dev/)
+[![Docs](https://img.shields.io/badge/Docs-uapis.cn-2EAE5D?style=flat-square)](https://uapis.cn/)
+
+> [!NOTE]
+> 所有接口的 Go 示例都可以在 [UApi](https://uapis.cn/docs/introduction) 的接口文档页面，向下滚动至 **快速启动** 区块后直接复制。
+
+## 快速开始
+
+```bash
+go get github.com/uapis/uapi-sdk-go@latest
+```
+
+```go
+package main
+
+import (
+	"fmt"
+	"github.com/uapis/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-go-sdk                      |
+| Python      | https://github.com/AxT-Team/uapi-python-sdk                  |
+| TypeScript| https://github.com/AxT-Team/uapi-typescript-sdk           |
+| Browser (TypeScript/JavaScript)| https://github.com/AxT-Team/uapi-browser-sdk        |
+| Java        | https://github.com/AxT-Team/uapi-java-sdk                    |
+| PHP         | https://github.com/AxT-Team/uapi-php-sdk                     |
+| C#          | https://github.com/AxT-Team/uapi-csharp-sdk                  |
+| C++         | https://github.com/AxT-Team/uapi-cpp-sdk                     |
+| Rust        | https://github.com/AxT-Team/uapi-rust-sdk                    |
+
+## 文档
+
+访问 [UApi文档首页](https://uapis.cn/docs/introduction) 并选择任意接口，向下滚动到 **快速启动** 区块即可看到最新的 Go 示例代码。

banner.png

@@ -0,0 +1,7 @@
+module github.com/uapis/uapi-sdk-go
+
+go 1.22
+
+require (
+	github.com/valyala/fasthttp v1.52.0
+)

go.mod

@@ -0,0 +1,24 @@
+# Compiled Object files, Static and Dynamic libs (Shared Objects)
+*.o
+*.a
+*.so
+
+# Folders
+_obj
+_test
+
+# Architecture specific extensions/prefixes
+*.[568vq]
+[568vq].out
+
+*.cgo1.go
+*.cgo2.c
+_cgo_defun.c
+_cgo_gotypes.go
+_cgo_export.*
+
+_testmain.go
+
+*.exe
+*.test
+*.prof

internal/.gitignore

@@ -0,0 +1,23 @@
+# OpenAPI Generator Ignore
+# Generated by openapi-generator https://github.com/openapitools/openapi-generator
+
+# Use this file to prevent files from being overwritten by the generator.
+# The patterns follow closely to .gitignore or .dockerignore.
+
+# As an example, the C# client generator defines ApiClient.cs.
+# You can make changes and tell OpenAPI Generator to ignore just this file by uncommenting the following line:
+#ApiClient.cs
+
+# You can match any string of characters against a directory, file or extension with a single asterisk (*):
+#foo/*/qux
+# The above matches foo/bar/qux and foo/baz/qux, but not foo/bar/baz/qux
+
+# You can recursively match patterns against a directory, file or extension with a double asterisk (**):
+#foo/**/qux
+# This matches foo/bar/qux, foo/baz/qux, and foo/bar/baz/qux
+
+# You can also negate patterns with an exclamation (!).
+# For example, you can ignore all files in a docs folder with the file extension .md:
+#docs/*.md
+# Then explicitly reverse the ignore rule for a single file:
+#!docs/README.md