示例与本地验算

下载

文件	用途
banner-request.json	单 imp Banner / App 请求
video-request.json	单 imp Video / Site 请求
native-request.json	Native JSON 字符串请求，版本示例为 1.2
bid-response.json	与 Banner 示例 ID 对齐的 DSP gross 报价，非 SSP 最终 net 响应
sign-request.mjs	Node.js 本地元数据签名；不发送网络请求
signature-vector.json	公开测试密钥、固定输入、原文和预期签名

全部域名、ID、素材及通知地址均为演示数据，不代表已配置伙伴或可访问的广告资源。JSON 示例只用于协议结构演示，不保证真实素材展示或 Native / VAST 全部校验。替换为合法、经双方确认的实际素材后才能做展示联调。

无凭证本地运行

安装 Node.js 24 或更高版本，将 sign-request.mjs 和 signature-vector.json 下载到同一目录，在没有本页所列 G24_* 环境输入的终端运行：

node sign-request.mjs

默认模式明确打印 PUBLIC TEST VECTOR ONLY 警告，标准输出只包含四个认证头，标准错误输出安全提示。它不访问 G24ad、不存储私钥，也不证明生产鉴权通过。测试向量固定时间与 Nonce，不可用于实时流量。

预期签名：

25c4e834eb439acc4a75b35fbbbb5fbb0dea3a90d0c7a79331c35325332e0539

测试密钥只是公开的 32 字节 0x11。原文使用八字段、七个 LF、无末尾 LF；CRLF 或末尾加 LF 都会得到不同签名。

使用真实输入，但仍不发请求

由受控凭证注入机制向 Node 进程提供下列环境变量。不要把真实 secret 写进 Shell 命令行、脚本、仓库或聊天，也不要把打印的头发送到公开日志。

环境变量	必选	含义
`G24_SECRET_BASE64`	是	安全取得的 32 字节规范 Base64 密钥
`G24_AUDIENCE`	是	双方约定 audience
`G24_SSP_ID`	是	SSP ID
`G24_KEY_ID`	是	本次使用的 key ID
`G24_TIMESTAMP_MS`	否	不设时使用当前 Unix 毫秒；固定值仅用于诊断
`G24_NONCE`	否	不设时生成 16 字节随机 Nonce；不要在实时调用中固定复用
`G24_REQUEST_PATH`	否	不设时由 SSP ID 构造；设置时必须完全相等，无 query

只配置部分环境输入会失败，不会静默回退到测试密钥。仍运行 node sign-request.mjs；任何命令行参数都会被拒绝。真实输入模式也只计算并打印头，不向任何地址发送请求。环境变量不是完整的秘密管理方案，运行环境与输出仍须妥善保护。

在客户端代码中引用

import { signRequest } from './sign-request.mjs';
import { randomBytes } from 'node:crypto';

const sspId = process.env.G24_SSP_ID;
const { headers } = signRequest({
  audience: process.env.G24_AUDIENCE,
  sspId,
  method: 'POST',
  path: `/openrtb/${sspId}`,
  keyId: process.env.G24_KEY_ID,
  timestampMs: String(Date.now()),
  nonce: randomBytes(16).toString('hex'),
  secretBase64: process.env.G24_SECRET_BASE64,
});
// 将 headers 交给受控客户端；此示例故意不发送网络请求。

signRequest 是纯计算函数，不读取环境、不生成时间或 Nonce、不保存去重状态，不修改传入对象。它校验必要标量和密钥格式，但不是生产 SDK，不判断服务端时间窗、凭证生效或 HTTP 重复头；发送端必须确保每个返回头只设置一次。不能据此宣称完整内存清零或秘密管理保证。

对齐报价预期

bid-response.json 中 gross 为 3.0，${AUCTION_PRICE} 尚未替换。若双方配置的 margin 为 10%，最终 SSP 响应的 net 为 2.700000，通知与 adm 中的价格宏使用 gross 字符串 3.000000。真实配置可能不同；不要把示例数值作为固定商业条件。

下一步：HMAC 认证 · 字段参考 · 上线清单。

协议与实现校核日期：2026-09-21。