短链点击推送

HTTP头信息

  1. Accept: application/json;charset=utf-8;
  2. Content-Type: application/json;charset=utf-8;

请求

URL: https://your_url
访问方式: POST
  • 该功能需要到后台”增长工具 - 云片短链接 - 设置”中开启。
  • 开通此接口后，我们将为您实时推送最新的短链点击信息。您需要提供一个 url 地址，接收 http POST 请求。具体字段信息见下表。
  • 处理成功请返回字符串”SUCCESS”或”0”，其他返回值将被认为是失败。
  • 推送失败后会重试，最多推送3次。

    请求内容

    请求内容为JSON Array，数组对象字段含义如下：
名称 类型 描述 示例值
trace_id String 本次访问唯一ID（如有重复推送问题，根据此字段去重） d1e1fb0f-ecc8-485d-8720-4776838f1966
url String 终端用户访问的短链URL https://dx5.cn/Y2oc82
sid String 终端用户访问的短链sid Y2oc82
master_sid String 主短链sid（发送包含主链的短信时，生成子链和手机号一一关联，这些子链归属于同一个主链） Y2oc82
visit_time Long 短链访问时间戳，毫秒数 1590379200000
client_ip String 终端用户IP 127.0.0.1
user_agent String 终端设备UA Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:63.0) Gecko/20100101 Firefox/63.0
referer String 终端设备请求头Referer
mobile String 终端用户手机号（需开启按手机号统计） 12345678910
redirect_url String 跳转后的地址 https://www.yunpian.com

请求示例：

curl -X POST 'http://your_url' \
  -H 'Content-Type: application/json;charset=utf-8;' \
  -H 'Accept: application/json;charset=utf-8;' \
  -d '[{
    "trace_id": "d1e1fb0f-ecc8-485d-8720-4776838f1966",
    "url": "https://dx5.cn/Y2oc82",
    "sid": "Y2oc82",
    "master_sid": "Y2oc82",
    "visit_time": 1590379200000,
    "client_ip": "127.0.0.1",
    "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:63.0) Gecko/20100101 Firefox/63.0",
    "referer": "",
    "redirect_url": "https://www.yunpian.com",
    "mobile": "12345678910"
  }]'