将 PartnerShare 内嵌到产品中

Embedded Referral Center

将 PartnerShare 内嵌到产品中

通过服务端登录接口为当前用户生成推广中心访问 Token，再将 PartnerShare 以 iframe 的方式嵌入你的产品后台。用户无需离开当前系统，也无需重复注册登录，即可直接查看推广链接、邀请数据、奖励和提现信息。

服务端生成 Token 自动注册或登录推广者 前端仅负责渲染 iframe 适合后台内嵌接入

1. 适用场景 #

如果你希望在自己的产品后台中增加“推广中心”“邀请赚钱”“联盟计划”等模块，并让用户在当前系统内直接完成推广相关操作，这种内嵌接入方式会比单独跳转到外部站点更自然，也更容易保持品牌体验一致。

2. 接入模式 #

推荐采用“你的前端发起访问、你的服务端换取 Token、PartnerShare 输出推广中心页面”的三段式接入结构。这样既能确保 API Secret 安全，也能让 iframe 页面保持稳定加载。

3. 页面效果示意 #

下图为内嵌后的后台效果示意。推广中心以页面模块的形式展示在你的产品后台中，用户可以在当前系统内直接查看推广数据、营销素材、专属链接和邀请码。

4. 前置要求 #

如果还不了解开放接口的鉴权方式，请先阅读 API 鉴权与签名机制。

5. 获取推广者登录 Token #

你的服务端需要先调用以下接口，为当前业务用户生成推广中心访问 Token。若该用户在 PartnerShare 中尚未存在，系统会自动创建推广者账号并加入默认推荐计划；若已存在，则直接复用并刷新登录状态。

5.1 请求头 #

5.2 请求参数 #

5.3 请求示例 #

curl -X POST "https://api-service.partnershare.net/api/open/v1/promoter/login" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: pk_xxxxxxxxxxxxxxxxxxxxx" \
  -H "X-Api-Timestamp: 1776677721" \
  -H "X-Api-Sign: calculated_signature" \
  -d '{
    "user_id": "user_10001",
    "email": "user@example.com",
    "username": "Alex",
    "lang": "zh",
    "theme_mode": "light"
  }'

5.4 响应示例 #

{
  "code": 0,
  "message": "success",
  "data": {
    "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
    "user_string_id": "ps8xk2m9qa",
    "lang": "zh",
    "theme_mode": "light"
  }
}

5.5 响应字段 #

6. 创建内嵌 iframe #

你的前端从自身服务端拿到 token 后，将 iframe 的 src 设置为 PartnerShare 推广中心地址即可。

<iframe
  src="https://promoter.partnershare.net/iframe/{{token}}"
  width="100%"
  height="900"
  frameborder="0"
  allow="clipboard-write"
></iframe>

7. 推荐的前后端分工 #

// 前端示例：仅请求你自己的服务端，不直接请求 PartnerShare
async function mountPartnerShareIframe() {
  const res = await fetch("/api/partner-share/iframe-token");
  const data = await res.json();

  document.querySelector("#partnerShareIframe").src =
    `https://promoter.partnershare.net/iframe/${data.token}`;
}

8. 常见问题 #

9. 接入检查清单 #