NotPanel 提供文档完整的 v3 action API,用于服务发现、幂等下单、状态与退款对账、补单、单项取消、余额读取及 HMAC 签名的 webhook。API key 的权限有意小于已登录的仪表盘会话。
每个 key 都是限定到账户的独立密钥。所有有效 key 共享账户的有效每分钟请求限制,并可在控制台撤销。
所有 key 共享一个由消费获得的滚动 60 秒账户限制,并另有 IP 和 action 保护。X-RateLimit 响应头描述有效窗口。
出站 webhook 为带重试的尽力而为投递,使用按端点的密钥和每次尝试的时间戳签名。接收方自行选择基于时间戳的重放策略,并使用 status 核对重要状态。
旧版 add 无需额外字段即可使用,相同请求体会获得 60 秒保护。request_id 或 idempotency_key 可选,用于精确重试;两者同时提供时以 request_id 为准。
重试不会造成重复交付,在可用取消窗口内取消的订单也不会在之后提交。
使用 key + action 的 reseller 客户端可直接更换基础 URL,继续调用 services、add、status、balance、refill、refill_status 和 cancel。v3 功能均为可选增量能力。
https://notpanel.com/api/v3每个请求都是向此 URL 发起的、带有 application/x-www-form-urlencoded 请求体的 POST。请求体必须包含 key 和 action;其余参数取决于具体 action。响应为 JSON。规范 URL 是 /api/v3;/api/v1 和 /api/v2 是当前 v3 合约的完全等价别名,不会改变行为。