短链点击推送

HTTP头信息

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



请求

URL: https://your_url
访问方式: POST



  • 该功能需要到后台"增长工具 - 云片短链接 - 设置"中开启。
  • 开通此接口后,我们将为您实时推送最新的模板审核状态报告。您需要提供一个 url 地址,接收 http POST 请求。具体字段信息见下表。
  • 处理成功请返回字符串"SUCCESS"或"0",其他返回值将被认为是失败。
  • 推送失败后会重试,最多推送3次。

请求内容

请求内容为JSON Array,数组对象字段含义如下:

名称类型描述示例值
trace_idString本次访问唯一ID(如有重复推送问题,根据此字段去重)d1e1fb0f-ecc8-485d-8720-4776838f1966
urlString终端用户访问的短链URLhttps://dx5.cn/Y2oc82
sidString终端用户访问的短链sidY2oc82
master_sidString主短链sid(发送包含主链的短信时,生成子链和手机号一一关联,这些子链归属于同一个主链)Y2oc82
visit_timeLong短链访问时间戳,毫秒数1590379200000
client_ipString终端用户IP127.0.0.1
user_agentString终端设备UAMozilla/5.0 (Windows NT 10.0; Win64; x64; rv:63.0) Gecko/20100101 Firefox/63.0
refererString终端设备请求头Referer 
mobileString终端用户手机号(需开启按手机号统计)12345678910
redirect_urlString跳转后的地址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"
  }]'