密钥与鉴权

rg_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# 方式 1：Authorization 请求头
curl --fail-with-body --max-time 20 \
  https://api.rendergrid.io/api/public/v1/balance \
  -H "Authorization: Bearer $RENDERGRID_API_KEY"

# 方式 2：X-API-Key 请求头
curl --fail-with-body --max-time 20 \
  https://api.rendergrid.io/api/public/v1/balance \
  -H "X-API-Key: $RENDERGRID_API_KEY"

import os
import requests

key = os.environ["RENDERGRID_API_KEY"]
response = requests.get(
    "https://api.rendergrid.io/api/public/v1/balance",
    headers={"Authorization": f"Bearer {key}"},
    timeout=(5, 20),
)
response.raise_for_status()
print(response.json())

// Node.js 22+，文件扩展名为 .mjs
const url = "https://api.rendergrid.io/api/public/v1/balance";
const key = process.env.RENDERGRID_API_KEY;
const response = await fetch(url, {
  headers: { Authorization: `Bearer ${key}` },
  signal: AbortSignal.timeout(20_000),
});
if (!response.ok) {
  const body = await response.text();
  throw new Error(`HTTP ${response.status}: ${body}`);
}
console.log(await response.json());

{
  "currency": "USD",
  "balance": "42.5000",
  "overdraft_limit": "0.0000",
  "available": "42.5000"
}

HTTP/1.1 401 Unauthorized

{
  "error": {
    "code": "ERR_API_KEY_INVALID",
    "message": "no API key on the request",
    "details": { "reason": "api_key_missing" }
  }
}