> For the complete documentation index, see [llms.txt](https://docs.tronsave.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tronsave.io/chinese/developers/code-examples.md).

# 代码示例

这些页面包含完整、可运行的脚本，端到端地演示了完整的 TronSave 集成流程——从构建并签名交易，到下单并确认订单已成交。每个示例都是自包含的：复制它，设置好你的凭证，然后运行即可。

示例分为两种类型：

* **API 密钥** — 使用 TronSave API 密钥进行身份验证。最适合从预付的 TronSave 余额中付款的后端服务。参见[身份验证](/chinese/developers/authentication.md)。
* **私钥** — 直接使用 TRON 账户的私钥进行签名和付款，无需预付余额。

{% hint style="info" %}
所有示例均使用 [TronWeb](https://tronweb.network/) `5.3.2`。通过以下命令安装：

```bash
npm i tronweb@5.3.2 @noble/secp256k1@1.7.1
```

更多内容请阅读 [TronWeb 5.3.2 发布说明](https://tronweb.network/docu/docs/5.3.2/Release%20Note/)。
{% endhint %}

{% hint style="warning" %}
大多数示例引用的是主网 TronSave 接收地址 `TWZEhq5JuUVvGtutNgnRBATbF8BnHGyn4S`。在针对测试网（Nile）运行时，请将其更改为 `TATT1UzHRikft98bRFqApFTsaSw73ycfoS`。参见[环境与网络](/chinese/developers/environments.md)。
{% endhint %}

## v2（当前）

新集成请使用这些示例。它们针对的是当前的 TronSave API。

| **示例**                                                                    | **身份验证** | **说明**                            |
| ------------------------------------------------------------------------- | -------- | --------------------------------- |
| [使用 API 密钥购买资源](/chinese/developers/code-examples/buy-with-api-key.md)    | API 密钥   | 预估成本并下单购买资源，从你的 TronSave 余额中付款。   |
| [使用私钥购买资源](/chinese/developers/code-examples/buy-with-private-key.md)     | 私钥       | 直接从 TRON 账户签名并支付资源订单。             |
| [使用 API 密钥延长订单](/chinese/developers/code-examples/extend-with-api-key.md) | API 密钥   | 延长一个活跃的代理（委托），从你的 TronSave 余额中付款。 |
| [使用私钥延长订单](/chinese/developers/code-examples/extend-with-private-key.md)  | 私钥       | 延长一个活跃的代理（委托），从 TRON 账户签名并付款。     |

## v0（旧版）

{% hint style="warning" %}
这些是旧版 v0 示例，仅供参考保留。新集成请使用上面的 v2 示例。
{% endhint %}

| **示例**                                                                      | **身份验证** | **说明**                       |
| --------------------------------------------------------------------------- | -------- | ---------------------------- |
| [使用 API 密钥购买能量](/chinese/developers/code-examples/buy-with-api-key-1.md)    | API 密钥   | 从你的 TronSave 余额中付款购买能量的旧版流程。 |
| [使用私钥购买能量](/chinese/developers/code-examples/buy-with-private-key-1.md)     | 私钥       | 从 TRON 账户签名购买能量的旧版流程。        |
| [使用 API 密钥延长订单](/chinese/developers/code-examples/extend-with-api-key-1.md) | API 密钥   | 使用 API 密钥延长一个活跃代理（委托）的旧版流程。  |

## 后续步骤

* [快速开始](/chinese/developers/quickstart.md) — 通往你第一笔订单的最短路径。
* [API 参考](/chinese/developers/api-reference.md) — 这些示例调用的每个端点。
* [SDK](/chinese/developers/sdk.md)（TypeScript、Rust、Python、Java 和 PHP）— 如果你不想直接调用 HTTP API，这是一个带类型的封装。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tronsave.io/chinese/developers/code-examples.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.