v2 — 使用 API 密钥延长

完整可运行的示例,演示如何使用 API 密钥延长已有的 TronSave 订单,提供 JavaScript、PHP 和 Python 版本。

这是一个完整、可运行的示例,演示如何使用 API 密钥延长 TronSave 上已有的订单。它分两步调用 v2 延长端点:首先预估哪些代理可被延长以及需要花费多少 TRX,然后提交延长请求并返回 orderId。

前提条件

你需要一个绑定到内部账户的 TronSave API 密钥。有两种获取方式:

• 方式 1: 在 TronSave 网站上生成 API 密钥。

• 方式 2: 在 Telegram 上生成 API 密钥。

关于这两种方式的详情,以及 API 密钥如何授权针对你内部账户的请求,请参阅 身份验证。

下面的 JavaScript 示例仅使用内置的 fetch API,不需要 TronWeb。原始来源提到相关示例需要 TronWeb 5.3.2;仅当你更广泛的集成需要签名时才安装它:

npm i [email protected] @noble/[email protected]

更多内容请阅读 TronWeb 5.3.2 发布说明。

工作原理

该流程使用两个端点:

1. /v2/get-extendable-delegates — 返回 extendData 负载、预估的 TRX 费用,以及是否可以延长。

2. /v2/extend-request — 提交 extendData 并返回 orderId。

运行前请设置以下变量:

变量	说明
API_KEY	你的 TronSave API 密钥。
RECEIVER	接收资源代理的地址。
RESOURCE_TYPE	ENERGY 或 BANDWIDTH。可选;默认为 ENERGY。
extendTo	你希望将代理延长到的时间,以秒为单位(Unix 时间戳)。
maxPriceAccepted	可选。你愿意为延长支付的最高价格(以 SUN 为单位)。

完整示例

JavaScript

const API_KEY = `your-api-key`;
const TRONSAVE_API_URL = "https://api.tronsave.io"
const RECEIVER = "your-receiver-address"
const RESOURCE_TYPE = "ENERGY"

const GetEstimateExtendData = async (extendTo, maxPriceAccepted) => {
    const url = TRONSAVE_API_URL + `/v2/get-extendable-delegates`
    const body = {
        extendTo, //time in seconds you want to extend to
        receiver: RECEIVER,   //the address that receives the resource delegate
        maxPriceAccepted, //Optional. Number the maximum price you want to pay to extend
        resourceType: RESOURCE_TYPE, //ENERGY or BANDWIDTH. optional. The default is ENERGY
    }
    const data = await fetch(url, {
        method: "POST",
        headers: {
            'apikey': API_KEY,
            "content-type": "application/json",
        },
        body: JSON.stringify(body)
    })
    const response = await data.json()
    /**
     * Example response 
     * @link  
       {
            "error": false,
            "message": "Success",
            "data": {
                "extendOrderBook": [
                    {
                        "price": 784,
                        "value": 1002
                    }
                ],
                "totalDelegateAmount": 5003,
                "totalAvailableExtendAmount": 5003,
                "totalEstimateTrx": 4085783,
                "isAbleToExtend": true,
                "yourBalance": 2377366851,
                "extendData": [
                    {
                        "delegator": "TGGVrYaT8Xoos...6dmSZkohGGcouYL4",
                        "isExtend": true,
                        "extraAmount": 0,
                        "extendTo": 1745833276
                    },
                    {
                        "delegator": "TQBV7xU489Rq8Z...zBhJMdrDr51wA2",
                        "isExtend": true,
                        "extraAmount": 0,
                        "extendTo": 1745833276
                    },
                    {
                        "delegator": "TSHZv6xsYHMRCbdVh...qNozxaPPjDR6",
                        "isExtend": true,
                        "extraAmount": 0,
                        "extendTo": 1745833276
                    }
                ]
            }
        }
     */
    return response
}

/**
 * @param {number} extendTo the time in seconds you want to extend to
 * @param {boolean} maxPriceAccepted number maximum price you want to pay to extend
 * @returns 
 */
const SendExtendRequest = async (extendTo, maxPriceAccepted) => {
    const url = TRONSAVE_API_URL + `/v2/extend-request`
    // Get estimate extendable delegates
    const estimateResponse = await GetEstimateExtendData(extendTo, maxPriceAccepted)
    const extendData = estimateResponse.data?.extendData
    if (extendData && extendData.length) { 
        const body = {
            extendData: extendData,
            receiver: RECEIVER,
        }
        const data = await fetch(url, {
            method: "POST",
            headers: {
                'apikey': API_KEY,
                "content-type": "application/json",
            },
            body: JSON.stringify(body)
        })
        const response = await data.json()
        /**
         * Example response 
         {
            error: false,
            message: 'Success',
            data: { orderId: '680b5ac7b09a385fb3d582ff' }
            }
         */
        return response
    }
    return []
}

//Example run code
const ClientCode = async () => { 
    const extendTo = Math.floor(new Date().getTime() / 1000) + 3 * 86400 //Extend to 3 next days
    const maxPriceAccepted = 900
    const response = await SendExtendRequest(extendTo, maxPriceAccepted)
    console.log(response)
}


ClientCode()

PHP

Python

后续步骤

• 获取可延长的代理 — 第 1 步的完整参考。

• 提交延长请求 — 第 2 步的完整参考。

• 身份验证 — 如何获取和使用 API 密钥。