Question

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_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"
  }]'