举金望开放平台 API 接入文档

1. 接入前必读

2. 开发者接入准备

接入前需要准备什么

客户会收到哪些联调参数

为什么没有“获取 token”步骤

举金望开放平台当前采用服务端签名鉴权模式。客户不需要先调用“获取 token”接口，也不需要维护临时访问令牌。每次请求时，客户服务端使用 AppId、当前秒级时间戳和 AppSecret 生成签名，并通过 Header 提交。

x-sign = sha256(app_id + timestamp + app_secret)

接口权限开通顺序

客户 0-1 接入顺序

1. 打开文档页：https://openapi.jujin.online。
2. 确认 API Base URL：https://openapi.jujin.online/api。
3. 检查网关：GET https://openapi.jujin.online/api/health。
4. 获取举金望分配的 AppId、AppSecret、placement_code。
5. 客户服务端生成 x-timestamp 和 x-sign。
6. 调用首轮接口：POST https://openapi.jujin.online/api/v1/chain/get。
7. 确认返回 code=200 且 data.url 非空。
8. 统一取链稳定后，再进入订单明细、推广数据和结算接口联调。

3. 使用步骤

3. 10分钟跑通统一取链

1. 向举金望获取 AppId、AppSecret、placement_code。
2. 确认接口地址：POST https://openapi.jujin.online/api/v1/chain/get。
3. 客户服务端生成秒级时间戳 x-timestamp。
4. 按 sha256(app_id + timestamp + app_secret) 生成 x-sign。
5. 发送请求，返回 code=200 且 data.url 有值即成功。

0-1 联调检查清单

4. 域名与接口地址

5. 鉴权签名

x-sign = sha256(app_id + timestamp + app_secret)

6. API 市场

POST /api/v1/chain/get

POST /api/v1/order/list

开放前由技术支持确认权限

开放前由技术支持确认权限

7. 统一取链接口详情

请求地址

POST https://openapi.jujin.online/api/v1/chain/get

请求 Body

{
  "product": "elm_redpacket",
  "promotion_method": "H5",
  "placement_code": "ZFBPP10",
  "sub_id": "client_user_001",
  "activity_id": 675,
  "link_type": 1
}

成功返回

{
  "code": 200,
  "message": "success",
  "data": {
    "product": "elm_redpacket",
    "promotion_method": "H5",
    "placement_code": "ZFBPP10",
    "url": "https://openapi.jujin.online/demo/promotion-link/xxx",
    "short_url": "",
    "deep_link": "",
    "mini_app_id": "",
    "mini_path": ""
  }
}

8. 饿了么红包接入说明

推荐接入方式

1. 客户前端把用户 ID、渠道 ID 或广告位 ID 传给客户服务端。
2. 客户服务端把该标识写入 sub_id。
3. 客户服务端调用统一取链接口。
4. 客户前端跳转或展示返回的 data.url。

9. 统一订单明细接口（新）

接口说明

用于查询客户通过举金望开放平台产生的订单明细，包括订单号、商品名称、订单状态、结算状态、付款金额、佣金金额、创建时间、付款时间、完成时间和客户自定义追踪标识。

请求 Header

请求 Body

{
  "product": "elm_redpacket",
  "activity_id": 675,
  "query_type": 1,
  "start_time": "2026-06-27 00:00:00",
  "end_time": "2026-06-27 23:59:59",
  "page": "",
  "page_size": 20
}

请求参数说明

返回字段说明

成功返回示例

{
  "code": 200,
  "message": "success",
  "data": {
    "next_page": "next_page_token",
    "rows": [
      {
        "order_no": "ORDER202606270001",
        "goods_name": "商品名称",
        "order_num": 1,
        "activity_id": 675,
        "order_status": 2,
        "settle_state": 0,
        "pay_amount": "28.90",
        "commission": "3.20",
        "tk_create_time": "2026-06-27 10:00:00",
        "tk_paid_time": "2026-06-27 10:02:00",
        "tk_finish_time": "",
        "sub_id": "client_user_001",
        "original_order_no": "",
        "ext_info": ""
      }
    ]
  }
}

订单状态说明

结算状态说明

curl 示例

APP_ID="请填写举金望分配的AppId"
APP_SECRET="请填写举金望分配的AppSecret"
BASE_URL="https://openapi.jujin.online/api"
TIMESTAMP=$(date +%s)

SIGN=$(python3 -c "import hashlib;print(hashlib.sha256(('${APP_ID}'+'${TIMESTAMP}'+'${APP_SECRET}').encode('utf-8')).hexdigest().lower())")

curl -X POST "$BASE_URL/v1/order/list" \
  -H "Content-Type: application/json" \
  -H "x-app-id: $APP_ID" \
  -H "x-timestamp: $TIMESTAMP" \
  -H "x-sign: $SIGN" \
  -d '{
    "product":"elm_redpacket",
    "activity_id":675,
    "query_type":1,
    "start_time":"2026-06-27 00:00:00",
    "end_time":"2026-06-27 23:59:59",
    "page":"",
    "page_size":20
  }'

10. 推广数据接口

用途：查看点击、转化、订单、预估收入等推广统计数据。

11. 结算对账接口

用途：查看结算周期、结算状态、分成结果和对账数据。

12. 错误码说明

13. 调试示例

curl 示例

APP_ID="请填写举金望分配的AppId"
APP_SECRET="请填写举金望分配的AppSecret"
BASE_URL="https://openapi.jujin.online/api"
TIMESTAMP=$(date +%s)

SIGN=$(python3 -c "import hashlib;print(hashlib.sha256(('${APP_ID}'+'${TIMESTAMP}'+'${APP_SECRET}').encode('utf-8')).hexdigest().lower())")

curl -X POST "$BASE_URL/v1/chain/get" \
  -H "Content-Type: application/json" \
  -H "x-app-id: $APP_ID" \
  -H "x-timestamp: $TIMESTAMP" \
  -H "x-sign: $SIGN" \
  -d '{"product":"elm_redpacket","promotion_method":"H5","placement_code":"ZFBPP10","sub_id":"client_user_001","activity_id":675,"link_type":1}'

Python 示例

import time, json, hashlib, requests

APP_ID = "请填写举金望分配的AppId"
APP_SECRET = "请填写举金望分配的AppSecret"
BASE_URL = "https://openapi.jujin.online/api"

timestamp = str(int(time.time()))
sign = hashlib.sha256((APP_ID + timestamp + APP_SECRET).encode("utf-8")).hexdigest().lower()

headers = {
    "Content-Type": "application/json",
    "x-app-id": APP_ID,
    "x-timestamp": timestamp,
    "x-sign": sign,
}

body = {
    "product": "elm_redpacket",
    "promotion_method": "H5",
    "placement_code": "ZFBPP10",
    "sub_id": "client_user_001",
    "activity_id": 675,
    "link_type": 1,
}

resp = requests.post(f"{BASE_URL}/v1/chain/get", headers=headers, json=body, timeout=20)
print(resp.status_code)
print(json.dumps(resp.json(), ensure_ascii=False, indent=2))

14. 常见问题

Q1：为什么打开 API Base URL 不是网页？

API Base URL 是接口调用前缀，不是文档页。文档页请访问 https://openapi.jujin.online。

Q2：为什么签名失败？

检查 AppId、AppSecret、timestamp、签名公式、sha256 小写结果，以及 Header 中的 x-timestamp 是否与签名使用的 timestamp 完全一致。

Q3：为什么请求已过期？

客户服务器时间和标准时间差距过大。请校准服务器时间。

Q4：为什么推广位越权？

检查 placement_code 是否为举金望分配给当前客户的推广位编码。

Q5：AppSecret 可以放小程序端吗？

不能。AppSecret 只能保存在服务端。

Q6：成功后使用哪个字段？

使用 data.url。

15. 技术支持

联调遇到问题，请提供：请求时间、AppId、placement_code、请求 Body、返回结果、错误码。请勿在公开群内发送 AppSecret。