对外 API 文档

本文档面向第三方调用方，覆盖以下内容：

• 公共参数约定
• API Key 获取方式
• 公共错误码
• 能量下单接口
• 激活接口

基础信息

• OpenAPI 前缀：/api/v1/openapi
• 数据格式：application/json
• 鉴权方式：
  • 获取 API Key 使用 JWT（Authorization: Bearer <token>）
  • OpenAPI 业务接口使用查询参数 apikey

统一响应结构

{
  "code": 200,
  "message": "SUCCESS",
  "data": {}
}

说明：

• code: 业务码（非 HTTP 状态码）
• message: 业务提示信息
• data: 业务数据（不同接口结构不同）

公共参数

本章节说明 OpenAPI 接口的公共请求参数。

查询参数

所有 OpenAPI 业务接口使用 GET + Query 参数：

示例

curl -G "https://api.gotoken.net/api/v1/openapi/getenergy" \
  --data-urlencode "apikey=your_api_key" \
  --data-urlencode "add=TRXxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  --data-urlencode "value=32000" \
  --data-urlencode "hour=24"

注意事项

• apikey 由登录后的用户在用户接口中获取。
• add 为目标地址字段，参数名固定为 add。
• 所有业务错误通过响应体 code/message 返回。

公共错误码

下表为对外接口常见公共错误码。

错误响应示例

{
  "code": 101001,
  "message": "参数错误: hour 不合法"
}

接口文档

本章节包含当前对外开放的 OpenAPI 接口：

• 能量下单
• 激活

每个接口均提供以下信息：

• 接口地址
• 请求参数
• 返回参数
• 代码示例
• 接口错误码

能量下单

该接口用于按套餐规则发起能量订单。

接口地址

• 方法：GET
• 地址：/api/v1/openapi/getenergy

请求参数

返回参数

代码示例

curl -G "https://api.gotoken.net/api/v1/openapi/getenergy" \
  --data-urlencode "apikey=your_api_key" \
  --data-urlencode "add=TRXxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  --data-urlencode "value=32000" \
  --data-urlencode "hour=24"

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	base := "https://api.gotoken.net/api/v1/openapi/getenergy"
	params := url.Values{
		"apikey": {"your_api_key"},
		"add":    {"TRXxxxxxxxxxxxxxxxxxxxxxxxxxxx"},
		"value":  {"32000"},
		"hour":   {"24"},
	}

	resp, err := http.Get(base + "?" + params.Encode())
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	body, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(string(body))
}

成功响应示例：

{
  "code": 200,
  "message": "SUCCESS",
  "data": {
    "orderId": "019c8ef8-2608-7e9e-aec8-712095c3ec79",
    "amount": "12.34"
  }
}

激活

该接口用于对指定 TRON 地址执行激活操作。

接口地址

• 方法：GET
• 地址：/api/v1/openapi/activation

请求参数

返回参数

代码示例

curl -G "https://api.gotoken.net/api/v1/openapi/activation" \
  --data-urlencode "apikey=your_api_key" \
  --data-urlencode "add=TRXxxxxxxxxxxxxxxxxxxxxxxxxxxx"

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	base := "https://api.gotoken.net/api/v1/openapi/activation"
	params := url.Values{
		"apikey": {"your_api_key"},
		"add":    {"TRXxxxxxxxxxxxxxxxxxxxxxxxxxxx"},
	}

	resp, err := http.Get(base + "?" + params.Encode())
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	body, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(string(body))
}

成功响应示例：

{
  "code": 200,
  "message": "SUCCESS",
  "data": {
    "txid": "4f7a...e991",
    "amount": "2.50"
  }
}

地址已激活示例：

{
  "code": 702001,
  "message": "地址已激活，无需激活"
}

接口错误码