开发者集成

本指南面向客户端、运营工具和外部节点的开发者。通过公开 HTTP API 集成已有站点，无需了解控制面内部代码。

准备测试站点复制标题链接

使用独立的测试站点、测试账号和支付渠道测试环境，不在真实客户订单上调试。本机实例按快速开始安装；配置统一保存在 apps/api/.env，从 apps/api/.env.example 复制，NODE_ENV=development 启用开发模式。

选择集成入口复制标题链接

目标	入口	前提
用户客户端	入口/api/v1/me/* 和认证端点	前提用户会话、资源所有权和门户能力
员工运营工具	入口/api/v1/admin/*	前提员工权限、本会话 MFA、敏感操作再验证
外部节点	入口/api/v1/node/*	前提注册后独立 Bearer、协议版本、批次持久化
支付提供商	入口渠道回调端点	前提签名、金额、币种和幂等规则

下载面板 OpenAPI和节点 OpenAPI，用所选语言生成客户端，或查看完整端点参考。不要把员工凭据放进公开浏览器代码。机器调用使用后台创建的服务账号 API Key（x-api-key），只能调用其角色权限范围内且不需要再验证的接口。

实现可靠调用复制标题链接

实现数值、错误、幂等和版本约定，持久化每次写入的业务意图和幂等键。外部节点按协议生命周期保存凭据及未确认批次，使用契约与模拟器验证。

上线前验证权限不足、过期会话、重复提交、版本冲突、限流和断网。记录 request id 和脱敏业务标识；日志中不包含 Cookie、Bearer、验证码或订阅地址。