> ## Documentation Index
> Fetch the complete documentation index at: https://docs.renaiss.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# SDK 与 API

> 了解 TypeScript SDK 和直接调用 Renaiss v2 HTTP API 两种接入方式。

> [card] [TypeScript SDK](https://docs.renaiss.xyz/cn/quickstart.md)
>
> 从 SDK 快速入门开始，了解如何在 TypeScript 中通过 `@renaiss-protocol/client` 调用 API。

> [card] [HTTP API](https://docs.renaiss.xyz/cn/api-reference.md)
>
> 在浏览器中发送第一个 HTTP 请求，再查看各接口的请求示例和错误响应。

## 接入方式对比

| 对比项 | TypeScript SDK | HTTP API |
| - | - | - |
| **开发语言** | TypeScript 或 JavaScript | 任何支持 HTTPS 请求的语言 |
| **响应** | SDK 校验响应并返回带类型的结果。 | 大多数接口返回 JSON。抽卡流通过服务器发送事件（SSE）推送进度。 |
| **签名** | 通过签名器连接外部账户（EOA）。 | 对准备接口返回的数据签名。抽卡和交易市场也支持符合条件的合约钱包。 |
| **分页** | 调用 `.firstPage()` 或用 `for await` 遍历。 | 按接口要求传入 `offset` 或 `cursor` 参数。 |

查询当前卡包和市场目录、分档回购报价、钱包收藏，或按请求 ID 轮询状态时，请使用 HTTP API。本指南对应的 SDK 测试版 `0.1.0-beta.4` 按旧版目录格式校验响应。详见 [SDK 版本兼容性](https://docs.renaiss.xyz/cn/typescript-sdk.md#版本兼容性)。

## 已接入的应用

为现有应用添加需要签名的操作或配送功能前，请查阅[各项操作所需凭据](https://docs.renaiss.xyz/cn/authentication.md#各项操作所需凭据)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.