API v3 保留熟悉的 key + action 契约和 JSON 响应。现有 reseller 客户端可直接更换基础 URL；v3 的高级字段和 action 都是可选扩展。
免费注册，通过 /register ——邮箱或 Google OAuth。生成 API key 无需信用卡；只有为真实订单给钱包充值时才需要资金。
登录后，前往 /dashboard/api。点击“Generate key”并复制原始值——它仅显示一次，之后不再显示。如果丢失，请将其吊销并生成新 key。每个用户最多可持有 5 个有效 key。
你的所有 key 共享账户的有效每分钟请求限制。累计成功消费决定自动等级；IP 和 action 限制也可能适用——请参阅 速率限制.
列出 services 是最简单的只读调用。action=services 返回有效服务的缓存兼容数组，包含面向账户的费率、min、max 和能力标志。需要分页、搜索、可用性、平台/分类元数据或新鲜度字段时，请使用 action=catalog。请将 YOUR_API_KEY 替换为第 2 步中的 key。
# 1. List active catalog services
curl -X POST https://notpanel.com/api/v3 \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "key=YOUR_API_KEY&action=services"const res = await fetch("https://notpanel.com/api/v3", {
method: "POST",
headers: { "Content-Type": "application/x-www-form-urlencoded" },
body: new URLSearchParams({
key: "YOUR_API_KEY",
action: "services",
}),
});
const services = await res.json();
console.log(`Found ${services.length} services`);import requests
res = requests.post(
"https://notpanel.com/api/v3",
data={"key": "YOUR_API_KEY", "action": "services"},
)
services = res.json()
print(f"Found {len(services)} services")<?php
$body = http_build_query([
'key' => 'YOUR_API_KEY',
'action' => 'services',
]);
$response = file_get_contents('https://notpanel.com/api/v3', false, stream_context_create([
'http' => [
'method' => 'POST',
'header' => "Content-Type: application/x-www-form-urlencoded\r\n",
'content' => $body,
],
]));
$services = json_decode($response, true);
echo "Found " . count($services) . " services\n";
需要让地区用户自然理解的名称？在 services 或 catalog 中加入 language=zh（也可用 en、es、pt、ru、tr、ar、hi、id、fr）。名称会按当地市场的真实用法采用精选的市场术语整理，品牌仍易于识别，响应还会说明实际使用的语言。省略该参数即可保持旧版英文结构不变。管理员可以审核或细化每个名称。
选择 service，为 wallet 充值，然后按服务类型字段调用 action=add。旧客户端可原样发送熟悉的请求。如需精确控制重试，可选添加一个最长 128 个字符的唯一 request_id。请参阅 下单 查看完整的参数列表。
轮询 状态 以查询单个订单或最多 100 个 ID 的批次。对于事件驱动的集成，请注册一个 webhook 以订阅六个受支持事件：order.completed、order.partial、order.processing、order.in_progress、order.refunded 和 order.refill_completed。投递为带重试的尽力而为模式；请使用 action=status 核对重要状态。
更换基础 URL 并保留熟悉的 key + action 调用。services、add、status、balance、refill、refill_status 和 cancel 可直接工作。需要时再采用 catalog、refund_quote、精确键、批量操作和签名 webhook。