边界与身份

接口依赖 DGJ2 登录态。sid 只取当前登录服务站；share_type、source、source_activity_id 由前端传入，与 SAAS 小程序统计接口保持同一结构。曝光传 share_type=4，站管家渠道传 source=2。

sequenceDiagram
    participant FE as 站管家活动前端
    participant DGJ as DGJ2 /scm/Share/create
    participant SAAS as SAAS /inner/dgj/share/create
    participant DB as t_statistics_share_log
    FE->>DGJ: share_type=4 + source=2 + source_activity_id
    DGJ->>DGJ: 注入登录态 sid，校验业务参数
    DGJ->>SAAS: sid + share_type + source + source_activity_id
    SAAS->>DB: 新增 platform=dgj 的曝光日志
    SAAS-->>DGJ: code=0
    DGJ-->>FE: code=0, data=[]

请求与响应

{
  "share_type": 4,
  "source": 2,
  "source_activity_id": 12345
}
{
  "success": true,
  "code": 0,
  "data": [],
  "msg": "记录成功"
}

share_type、source 或 source_activity_id 缺失、非整数或不大于 0 时返回 code=-401329。SAAS 返回非成功时，DGJ2 返回 code=-401001 和“统计记录失败，请稍后重试”。

数据语义

  • SAAS 使用前端传入的 source，仅固定 platform=dgj。source=1 表示小程序、source=2 表示 E站 APP/站管家；曝光由 share_type=4 表示。
  • share_type=1 分享、2 点击分享、3 H5 浏览、4 曝光、5 机器人分享；定义来自预发表字段注释。
  • 曝光统计不是幂等命令；每次成功调用都新增记录。
  • DGJ2 不新增表、缓存、配置、MQ 或回调。

兼容与失败

  • 新增独立 Controller/Service，不修改保护文件或旧 H5 入口。
  • 参数校验失败时不调用 SAAS。
  • SAAS 超时或失败不产生已确认的成功响应；前端可按产品策略异步重试，但必须接受可能重复计数。
  • 统计接口不承担活动状态、可见范围和参与资格校验。

契约位置

  • 本地：doc/ai/contracts/api/activity-share-exposure.md
  • Apipost：项目 2773b9，目录“站管家2.0 / 营销 / 活动专区 / 站管家接口”，API ID 62c27a5de3d4d