> 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/authentication.md).
# 身份认证
每个 TronSave API 请求都必须经过身份验证。有两种方式：与 TronSave **内部账户**绑定的 **API 密钥**，或者**签名交易**（即每次购买时从你自己的钱包付款）。本页将说明这两种方式，并展示如何在网站上或通过 Telegram 获取 API 密钥。
## 内部账户和 API 密钥
TronSave **内部账户**是由 TronSave 管理的余额。你只需向其中存入一次 TRX，之后当你下单时，API 会自动从该余额中扣款。它还会记录你的交易历史，并让你在系统内管理资产。
每个内部账户都会分配一个唯一的 **API 密钥**——这是由 TronSave 发放并关联到该账户的一个秘密标识符。API 密钥让你或第三方应用（机器人、自动化服务）无需登录网站或应用即可向内部账户发送指令。每个请求——查询余额、创建订单、延长订单——都通过 API 密钥与内部账户关联。
简而言之：
* **内部账户**是存储和管理你资产的地方。
* **API 密钥**是授予对该账户进行安全、自动化访问的工具。
{% hint style="warning" %}
你的 API 密钥控制着从内部账户中的支出。请像对待密码一样对待它：切勿将其提交到源代码管理中，切勿在客户端代码中暴露它，也切勿分享它。任何持有你密钥的人都可以下单，花费你存入的 TRX。
{% endhint %}
## 两种身份验证方式
| | API 密钥 | 签名交易 |
| -------- | ---------------------------- | ------------------------ |
| **工作原理** | 请求携带你的 API 密钥；订单从你的内部账户余额中支付 | 每次购买时，你从自己的钱包签名一笔 TRX 付款 |
| **托管方式** | 资金保存在由 TronSave 管理的内部账户中 | 完全自托管——资金由你自己保管 |
| **设置** | 获取 API 密钥，存入一次 TRX | 无需存款；每笔交易单独签名 |
| **适用场景** | 频繁调用的机器人和自动化服务 | 希望保留资金托管权并按需付款的用户 |
| **发送方式** | `apikey` 请求头 | 请求体中的一笔签名交易 |
{% hint style="info" %}
使用 API 密钥方式时，你在 `apikey` 请求头中发送密钥：
```bash
curl -X POST https://api.tronsave.io/v2/buy-resource \
-H "apikey: YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{ ... }'
```
{% endhint %}
关于此处使用的术语，请参阅[术语表](/chinese/concepts/glossary.md)。
## 获取 API 密钥
你可以直接从**网站**或通过 **Telegram** 获取 API 密钥。
{% tabs %}
{% tab title="在网站上" %}
**第 1 步 — 获取存款地址和 API 密钥**
1. 前往 [tronsave.io](https://tronsave.io/market)。
2. 点击 **Connect** 按钮。
3. 选择一个钱包选项并登录以连接。
4. 连接后，选择 **Account info**。
5. 点击 **Login TRONSAVE** 按钮并 **Sign**（签名）。
6. 你的 API 密钥和存款地址将会显示出来。
{% hint style="info" %}
**注意：** 如果你使用的是 **Nile 测试网**，请改用此 URL：[`https://testnet.tronsave.io/`](https://testnet.tronsave.io/)
{% endhint %}
**第 2 步 — 通过转入 TRX 进行存款**
1. 点击 **Top up** 按钮以获取存款地址。
2. 将 TRX 转入此地址。
3. **Sign**（签名）以确认交易。
4. 新余额会在大约 3 秒内自动更新。
{% hint style="info" %}
* 最低存款额为 **10 TRX**。
* 你的首次存款需要额外支付约 **1 TRX** 的费用以激活新地址。
* 每天你可以进行 **2 笔** TRX 存款交易而无需手续费。超过之后，每笔额外的存款将产生 **0.3 TRX** 的手续费。
{% endhint %}
{% endtab %}
{% tab title="在 Telegram 上" %}
1. 打开 TronSave Telegram 机器人（[@BuyEnergyTronsave\_bot](https://t.me/BuyEnergyTronsave_bot)）并进入 **User Info**。
2. 选择 **API key** 按钮。
3. 点击 API 密钥即可复制它。
{% endtab %}
{% endtabs %}
## 撤销和轮换你的密钥
如果你需要更改 API 密钥，请选择 **Revoke**（撤销）以生成一个新密钥。在网站和 Telegram 上的操作方式相同：确认操作以创建新密钥，或取消以保留当前密钥。
{% hint style="warning" %}
我们不建议更改 API 密钥。撤销会使旧密钥失效——任何仍在使用它的机器人或服务都将停止工作。仅在必要时才进行撤销（例如，密钥可能已被泄露）。
{% endhint %}
## 后续步骤
* [开发者快速开始](/chinese/developers/quickstart.md) — 获取密钥、存款并下你的第一个订单
* [API 参考](/chinese/developers/api-reference.md) — 完整的端点列表
* [术语表](/chinese/concepts/glossary.md) · [订单类型](/chinese/concepts/order-types.md)
---
# 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/authentication.md?ask=
```
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.
