BridgeX API 代码示例

安全提示：不要把 API Key 写入网页、小程序或公开仓库。服务端调用必须设置 Idempotency-Key，避免重复订单。

Go · 创建 Mock SMS 订单

package main

import (
  "bytes"
  "net/http"
)

func main() {
  body := []byte(`{"product_code":"mock-us-1001"}`)
  req, _ := http.NewRequest("POST", "https://api.bridgex.cc/v1/sms/orders", bytes.NewReader(body))
  req.Header.Set("Content-Type", "application/json")
  req.Header.Set("X-API-Key", "YOUR_BRIDGEX_API_KEY")
  req.Header.Set("Idempotency-Key", "order-20260809-0001")
  resp, err := http.DefaultClient.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
}

JavaScript · Node.js 服务端调用

const response = await fetch('https://api.bridgex.cc/v1/sms/orders', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': process.env.BRIDGEX_API_KEY,
    'Idempotency-Key': 'order-20260809-0001'
  },
  body: JSON.stringify({ product_code: 'mock-us-1001' })
})

const result = await response.json()
console.log(result.request_id, result.data)

Python · requests

import os
import requests

response = requests.post(
    "https://api.bridgex.cc/v1/sms/orders",
    headers={
        "X-API-Key": os.environ["BRIDGEX_API_KEY"],
        "Idempotency-Key": "order-20260809-0001",
    },
    json={"product_code": "mock-us-1001"},
    timeout=15,
)
response.raise_for_status()
result = response.json()
print(result["request_id"], result["data"])

最小权限

查订单使用 sms:read，创建订单才增加 sms:write；钱包查询单独使用 wallet:read。

限流响应

读取 X-RateLimit-Limit、Remaining 和 Reset；收到 429 后按 Reset 时间重试。

问题定位

保存每次响应的 request_id。联系管理员时只提供 request_id，不要提供完整 API Key。