运行时 API
节点运行时 API 由 RGB 闪电网络节点自身提供,用于开通道、收发支付与操作 RGB 资产。它在节点的专属域名上访问,使用节点自身的凭证。
访问方式
节点详情返回 public_dns 与 api_base_url,即节点的 HTTPS 域名。运行时接口位于该域名的 /api/v1/* 下,控制面接口位于根路径(如 /control/status)。
运行时接口需要节点自身的 Bearer 凭证,例如自有节点的 api_token / control_token。节点域名可达不等于已获得访问授权,缺少有效凭证的请求会被拒绝。
与 Cloud API Key 的边界
Cloud 管理 API 的 API Key 仅用于节点管理:创建、查询、启停、删除与 P2P 地址申请。API Key 不能调用节点原生接口,也不是节点运行时凭证;请勿把 Cloud API Key 发送到节点域名。
节点详情中的 api_base_url 只表示原生请求的 HTTPS 地址,不构成访问授权,也不表示节点已就绪。若请求体或响应以 api_base_url 作为可调用依据,需改为按部署提供的授权方式访问。
P2P 连接地址
Lightning P2P 连接使用节点管理接口返回的 p2p_* 字段(p2p_host、p2p_port、p2p_address),通过 POST /v3/nodes/{id}/p2p 为运行中的用户节点申请。HTTPS API 地址不是 P2P 连接地址;申请 P2P 地址不会授予通道或支付接口的访问权限。
接口范围
节点运行时接口按能力分组(节点状态、控制面、对等体、钱包与 UTXO、通道、支付、RGB、原子交换、网络图谱),逐条说明见 RGB 闪电网络节点 API。接口格式以节点软件的 rgb-ldk-api-public OpenAPI 规范为准。