能量交易平台开发文档

export WWTRX_API_BASE="https://haiou.io"
export WWTRX_API_KEY="YOUR_API_KEY"
export TRON_RECEIVE_ADDRESS="YOUR_TRON_ADDRESS"

# 从服务端环境读取真实密钥，不要把密钥拼进 URL。
curl --silent --show-error --max-time 15 \
  --request POST "https://haiou.io/api/balance" \
  --data-urlencode "apikey=${WWTRX_API_KEY:?请先设置 WWTRX_API_KEY}"

# 生成：name 使用 URL 编码，避免中文或特殊字符被破坏。
curl --silent --show-error --max-time 15 \
  --request POST "https://haiou.io/api/user/generateApiKey" \
  --header "token: ${WWTRX_USER_TOKEN:?请先设置登录 Token}" \
  --data-urlencode "name=订单服务生产环境"

# 查询：生成响应不包含 id，删除前从本人列表读取 id。
curl --silent --show-error --max-time 15 \
  "https://haiou.io/api/user/getApikeylist?page=1" \
  --header "token: ${WWTRX_USER_TOKEN:?请先设置登录 Token}"

# 删除会立即影响后续调用，且不可恢复。
# 将 KEY_ID_TO_DELETE 设置为上面列表中确认要删除的 id。
curl --silent --show-error --max-time 15 \
  --request POST "https://haiou.io/api/user/deleteApiKey" \
  --header "token: ${WWTRX_USER_TOKEN:?请先设置登录 Token}" \
  --data-urlencode "id=${KEY_ID_TO_DELETE:?请先确认要删除的密钥 id}"

# Node.js 18+，将下方 JavaScript 作为 energy-api.mjs 运行。
npm install axios
node energy-api.mjs             # 只验证密钥，不下单
node energy-api.mjs --send      # 确认接收地址、余额、规格后，单独执行一次

# Python 3.10+，将下方 Python 作为 energy_api.py 运行。
python3 -m pip install requests
python3 energy_api.py           # 只验证密钥，不下单
python3 energy_api.py --send     # 确认后，单独执行一次；不要与 Node 示例重复下单

import axios from 'axios'

const baseURL = process.env.WWTRX_API_BASE || 'https://haiou.io'
const apikey = process.env.WWTRX_API_KEY
if (!apikey || apikey === 'YOUR_API_KEY') {
  throw new Error('请在服务端设置真实 WWTRX_API_KEY')
}
const base = new URL(baseURL)
if (base.protocol !== 'https:' || base.username || base.password ||
    base.pathname !== '/' || base.search || base.hash) {
  throw new Error('WWTRX_API_BASE 必须是网站的 HTTPS 域名，不带路径或账号信息')
}

const client = axios.create({ baseURL: base.origin, timeout: 15000 })

async function request(path, payload) {
  const { data } = await client.post(path, payload, {
    headers: { 'Content-Type': 'application/json' },
  })
  if (data?.code !== 1) {
    throw new Error(data?.msg || 'API 返回失败，请检查原始响应')
  }
  return data.data
}

try {
  const allowance = await request('/api/balance', { apikey })
  console.log('密钥验证通过；接口参考次数（不是 TRX 余额）：', allowance)

  if (process.argv.includes('--send')) {
    const receiveAddress = process.env.TRON_RECEIVE_ADDRESS || ''
    if (!/^T[1-9A-HJ-NP-Za-km-z]{33}$/.test(receiveAddress)) {
      throw new Error('请设置有效的 TRON_RECEIVE_ADDRESS，并核对实际接收方')
    }
    const order = await request('/api/send', {
      apikey,
      receiveAddress,
      energyAmount: 65000,
      rentTime: 1,
      resLock: 0,
    })
    if (!order?.orderId) {
      throw new Error('未获得订单号，结果未知；请到接口订单列表核对，不要自动重试')
    }
    // 生产系统需将 orderId 与自己的业务单号持久化关联。
    console.log('订单已提交：', order.orderId, '订单金额：', order.orderMoney)
  }
} catch (error) {
  // 不直接打印 Axios 错误对象，其中可能含有密钥和请求体。
  console.error(error.response?.data?.msg || error.message)
  console.error('若已发起下单且结果不明，请先核对接口订单列表，不要重复提交。')
  process.exitCode = 1
}

import os
import re
import sys
from urllib.parse import urlsplit

import requests

base = os.getenv("WWTRX_API_BASE", "https://haiou.io").rstrip("/")
apikey = os.getenv("WWTRX_API_KEY", "")
if not apikey or apikey == "YOUR_API_KEY":
    raise SystemExit("请在服务端设置真实 WWTRX_API_KEY")
origin = urlsplit(base)
if (origin.scheme != "https" or not origin.netloc or origin.path or
        origin.query or origin.fragment or origin.username or origin.password):
    raise SystemExit("WWTRX_API_BASE 必须是网站的 HTTPS 域名，不带路径或账号信息")


def request(path, payload):
    # 不配置自动重试，尤其不能对创建订单进行盲目补发。
    response = requests.post(base + path, json=payload, timeout=15)
    try:
        result = response.json()
    except ValueError:
        raise RuntimeError("响应不是 JSON；若已经下单，请先核对订单结果")
    if not isinstance(result, dict):
        raise RuntimeError("响应结构异常；若已经下单，请先核对订单结果")
    if not response.ok or result.get("code") != 1:
        raise RuntimeError(result.get("msg") or "API 请求失败")
    return result.get("data")


try:
    allowance = request("/api/balance", {"apikey": apikey})
    print("密钥验证通过；接口参考次数（不是 TRX 余额）：", allowance)

    if "--send" in sys.argv:
        address = os.getenv("TRON_RECEIVE_ADDRESS", "")
        if not re.fullmatch(r"T[1-9A-HJ-NP-Za-km-z]{33}", address):
            raise RuntimeError("请设置有效的 TRON_RECEIVE_ADDRESS，并核对实际接收方")
        order = request("/api/send", {
            "apikey": apikey,
            "receiveAddress": address,
            "energyAmount": 65000,
            "rentTime": 1,
            "resLock": 0,
        })
        if not isinstance(order, dict) or not order.get("orderId"):
            raise RuntimeError("未获得订单号，结果未知；请先核对订单，不要自动重试")
        # 生产系统需将 orderId 与自己的业务单号持久化关联。
        print("订单已提交：", order["orderId"], "订单金额：", order.get("orderMoney"))
except requests.RequestException:
    print("网络请求失败或超时；若已下单，结果可能未知，请先核对订单。", file=sys.stderr)
    sys.exit(1)
except RuntimeError as error:
    print(str(error), file=sys.stderr)
    sys.exit(1)