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-java@v4
+        with: { distribution: 'temurin', java-version: '17' }
+      - run: mvn -q -DskipTests package

.gitignore

@@ -0,0 +1,6 @@
+.DS_Store
+.idea/
+.vscode/
+dist/
+build/
+coverage/

README.md

@@ -0,0 +1,73 @@
+# uapi-sdk-java
+
+![Banner](./banner.png)
+
+[![Java](https://img.shields.io/badge/Java-17+-EA2D2F?style=flat-square&logo=openjdk&logoColor=white)](https://adoptium.net/)
+[![Docs](https://img.shields.io/badge/Docs-uapis.cn-2EAE5D?style=flat-square)](https://uapis.cn/)
+
+> [!NOTE]
+> 所有接口的 Java 示例都可以在 [UApi](https://uapis.cn/docs/introduction) 的接口文档页面，向下滚动至 **快速启动** 区块后直接复制。
+
+## 快速开始
+
+```bash
+git clone https://github.com/AxT-Team/uapi-sdk-java.git
+cd uapi-sdk-java
+mvn -q package
+```
+
+```java
+import uapi.Client;
+import java.util.Map;
+
+public class Demo {
+    public static void main(String[] args) throws Exception {
+        var client = new Client("https://uapis.cn/api/v1", "");
+        var info = client.social().getSocialQqUserinfo(Map.of("qq", "10001"));
+        System.out.println(info);
+    }
+}
+```
+
+## 特性
+
+现在你不再需要反反复复的查阅文档了。
+
+只需在 IDE 中键入 `client.`，所有核心模块——如 `social()`、`game()`、`image()`——即刻同步展现。进一步输入即可直接定位到 `getSocialQqUserinfo` 这样的具体方法，其名称与文档的 `operationId` 严格保持一致，确保了开发过程的直观与高效。
+
+所有方法签名只接受真实且必需的参数。当你在构建请求时，IDE 会即时提示 `qq`、`username` 等键名，这彻底杜绝了在 `Map<String, Object>` 中因键名拼写错误而导致的运行时错误。
+
+针对 401、404、429 等标准 HTTP 响应，SDK 已将其统一映射为具名的异常类型（`UapiException.Unauthorized`、`UapiException.NotFound`、`UapiException.ServiceBusy` 等）。这些异常均附带 `status`、`code`、`details` 等关键上下文信息，确保你在日志中能第一时间准确、快速地诊断问题。
+
+基础域名、请求超时和 `User-Agent` 已预设为合理的默认值。但你完全拥有控制权，可以通过 `new Client(baseUrl, token)` 结合 OkHttp 自定义拦截器，灵活覆盖 Token、BaseURL 等配置。
+
+如果你需要查看字段细节或内部逻辑，仓库中的 `./internal` 目录同步保留了由 `openapi-generator` 生成的完整结构体，随时可供参考。
+
+## 错误模型概览
+
+| HTTP 状态码 | SDK 错误类型                                  | 附加信息                                                                          |
+|-------------|----------------------------------------------|------------------------------------------------------------------------------------|
+| 401/403     | `UapiException.Unauthorized`                 | `code`、`status`                                                                   |
+| 404         | `UapiException.NotFound` / `UapiException.NoMatch` | `code`、`status`                                                              |
+| 400         | `UapiException.InvalidParameter` / `UapiException.InvalidParams` | `code`、`status`、`details`             |
+| 429         | `UapiException.ServiceBusy`                  | `code`、`status`、`retry_after_seconds`                                           |
+| 5xx         | `UapiException.InternalServerError` / `UapiException.ApiError` | `code`、`status`、`details`              |
+| 其他 4xx    | `UapiException`                              | `code`、`status`、`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) 并选择任意接口，向下滚动到 **快速启动** 区块即可看到最新的 Java 示例代码。

banner.png

@@ -0,0 +1,30 @@
+# This workflow will build a Java project with Maven, and cache/restore any dependencies to improve the workflow execution time
+# For more information see: https://help.github.com/actions/language-and-framework-guides/building-and-testing-java-with-maven
+#
+# This file is auto-generated by OpenAPI Generator (https://openapi-generator.tech)
+
+name: Java CI with Maven
+
+on:
+  push:
+    branches: [ main, master ]
+  pull_request:
+    branches: [ main, master ]
+
+jobs:
+  build:
+    name: Build UAPI
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        java: [ 17, 21 ]
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up JDK
+      uses: actions/setup-java@v4
+      with:
+        java-version: ${{ matrix.java }}
+        distribution: 'temurin'
+        cache: maven
+    - name: Build with Maven
+      run: mvn -B package --no-transfer-progress --file pom.xml

internal/.github/workflows/maven.yml

@@ -0,0 +1,21 @@
+*.class
+
+# Mobile Tools for Java (J2ME)
+.mtj.tmp/
+
+# Package Files #
+*.jar
+*.war
+*.ear
+
+# exclude jar for gradle wrapper
+!gradle/wrapper/*.jar
+
+# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
+hs_err_pid*
+
+# build files
+**/target
+target
+.gradle
+build

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