uapi-browser-sdk

Note

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

快速开始

npm i uapi-browser-sdk

import { UapiClient } from 'uapi-browser-sdk'

const client = new UapiClient('https://uapis.cn/api/v1')
const result = await client.social.getSocialQqUserinfo({ qq: '10001' })
console.log(result)

特性

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

只需在 IDE 中键入 client.，所有核心模块——如 social、game、image——即刻同步展现。进一步输入即可直接定位到 getSocialQqUserinfo 这样的具体方法，其名称与文档的 operationId 严格保持一致，确保了开发过程的直观与高效。

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

针对 401、404、429 等标准 HTTP 响应，SDK 已将其统一映射为 UapiError。错误对象自带 code、status 与 details 字段，确保你在浏览器日志中能第一时间准确、快速地诊断问题。

SDK 采用原生 fetch，自动补上 Authorization 头且不依赖任何 Node.js API；需要自定义超时或重试时，只要包装 _request 或替换调用处即可。

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

错误模型概览

HTTP 状态码	SDK 错误类型	附加信息
401/403	UapiError	code、status、details
404	UapiError	code、status
400	UapiError	code、status、details
429	UapiError	code、status、retry_after_seconds
5xx	UapiError	code、status

其他 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文档首页 并选择任意接口，向下滚动到 快速启动 区块即可看到最新的 Browser (TypeScript) 示例代码。