天天外链API对接文档

天天外链2023年07月06日

目前天天外链支持链接自定义参数跳转,无需开发:

基础链接与users_id请联系客服获取

一、个人外链列表

接口地址为基础网址+links/users_links_lists,请求方法为GET

1、请求参数:

  • users_id: 用户ID,联系客服获取

2、返回参数:

  • links_id: 链接ID
  • title: 外链标题
  • platfrom: 外链类型(1.公众号 2.小程序 3.客服)
  • status: 外链状态(1.可用2.未续费3.已关闭4.已删除)
  • pv: 链接访问量
  • miniapp_pv: 小程序访问量

参数示例:

{
    "status": "success",
    "code": "1000",
    "msg": "链接列表获取成功!",
    "data": [{
        "links_id": "test",
        "title": "官方示例-引流到公众号文章",
        "platfrom": 1,
        "status": 1,
        "limit_pv": 1000000,
        "limit_status": 1,
        "pv": 682,
        "miniapp_pv": 297,
        "created_at": "2021-01-20 08:28:56"
    }, {
        "links_id": "services",
        "title": "官方示例-引流到微信客服",
        "platfrom": 3,
        "status": 1,
        "limit_pv": 10000,
        "limit_status": 2,
        "pv": 12,
        "miniapp_pv": 4,
        "created_at": "2021-01-20 08:28:56"
    }, {
        "links_id": "miniapp",
        "title": "官方示例-引流到小程序",
        "platfrom": 3,
        "status": 1,
        "limit_pv": 10000,
        "limit_status": 2,
        "pv": 9,
        "miniapp_pv": 2,
        "created_at": "2021-01-20 08:28:56"
    }]
}

二、个人外链详情

接口地址为基础网址+links/users_links_detial,请求方法为GET

1、请求参数:

  • users_id: 用户ID,联系客服获取
  • links_id: 链接ID

2、返回参数:

  • links_id: 链接ID
  • title: 外链标题
  • platfrom: 外链类型(1.公众号 2.小程序 3.客服)
  • describe: 按钮描述(platfrom为2、3时有效)
  • image: 按钮封面(platfrom为2、3时有效)
  • msg: 外链内容,参考下方说明
  • status: 外链状态(1.可用2.未续费3.已关闭4.已删除)
  • pv: 链接访问量
  • miniapp_pv: 小程序访问量
  • limit_pv: 访问限制PV(limit_status为2时不限制)
  • limit_status: 访问限制状态(1.限制2.不限制)
  • created_at: 创建时间
  • url: 外链链接

参数示例:

{
    "status": "success",
    "code": "1000",
    "msg": "链接详情获取成功!",
    "data": {
        "links_id": "test",
        "title": "官方示例-引流到公众号文章",
        "describe": "",
        "platfrom": 1,
        "msg": "https://mp.weixin.qq.com/s/ZjHiqx39d7kVUm8z3xsyng",
        "status": 1,
        "limit_pv": 1000000,
        "limit_status": 1,
        "pv": 682,
        "miniapp_pv": 297,
        "created_at": "2021-01-20T08:28:56.000000Z",
        "url": "https://wx.n6nck.cn/links/test"
    }
}

三、删除外链

接口地址为基础网址+links/users_links_delete,请求方法为GET

1、请求参数:

  • users_id: 用户ID,联系客服获取
  • links_id: 链接ID

2、返回参数:

参数示例:

{
    "status": "success",
    "code": "1000",
    "msg": "链接删除成功!",
}

四、创建外链

接口地址为基础网址+links/links_publist,请求方法为POSTfrom-data类型。

1、请求参数:

  • users_id: 用户ID,联系客服获取
  • title: 外链标题
  • msg: 外链内容,参考下方说明
  • platfrom: 外链类型(1.公众号 2.小程序 3.客服)
  • platfrom_type: 子类型
  • urlscheme:小程序urlscheme(platfrom_type为5时有效)
  • notice: 提示类型(platfrom_type为2、3、6时有效)
  • notice_img:提示图片(platfrom_type为2、3、6时有效)
  • describe_show:是否显示按钮(platfrom_type为2、3、6时有效)
  • describe: 按钮描述(platfrom_type为2、3、6时有效)
  • image: 按钮封面(platfrom_type为2、3、6时有效)

2、请求示例

msg内容参考下方文档

"users_id": "必填",
"title": "小程序外链测试,必填",
"msg": "{'path':'pages/index/index','mini_id':'wx58***}",
"platfrom": 2,
"platfrom_type":4,
"describe": "",
"image": "",
"notice":1,
"notice_img":"",
"describe_show":"2",
"urlscheme":"",

3、返回参数:

参数示例:

{
    "status": "success",
    "code": "1000",
    "msg": "链接创建成功!",
    "data": {"url":"外链"}
}

五、更新外链

接口地址为基础网址+links/links_update,请求方法为POSTfrom-data类型。

1、请求参数:

  • users_id: 用户ID,联系客服获取
  • links_id: 链接ID
  • title: 外链标题
  • msg: 外链内容,参考下方说明
  • platfrom: 外链类型(1.公众号 2.小程序 3.客服)
  • platfrom_type: 子类型
  • urlscheme:小程序urlscheme(platfrom_type为5时有效)
  • notice: 提示类型(platfrom_type为2、3、6时有效)
  • notice_img:提示图片(platfrom_type为2、3、6时有效)
  • describe_show:是否显示按钮(platfrom_type为2、3、6时有效)
  • describe: 按钮描述(platfrom_type为2、3、6时有效)
  • image: 按钮封面(platfrom_type为2、3、6时有效)

2、请求示例

msg内容参考下方文档

"users_id": "必填",
"links_id": "必填",
"title": "小程序外链测试,必填",
"msg": "{'path':'pages/index/index','mini_id':'wx58***}",
"platfrom": 2,
"platfrom_type":4,
"describe": "",
"image": "",
"notice":1,
"notice_img":"",
"describe_show":"2",
"urlscheme":"",

3、返回参数:

参数示例:

{
    "status": "success",
    "code": "1000",
    "msg": "链接更新成功!",
}

六、msg参数说明

platfrom_type为1(跳转公众号文章):

  • msg: 公众号文章链接,需要公众号授权 如: https://mp.weixin.qq.com/s/ZjHiqx39d7kVUm8z3xsyng

platfrom_type为4(小程序-密钥版):

如每个用户添加一个Urlscheme推荐使用此版本;需要提前在天天外链小程序个人最新添加小程序

  • msg: 小程序配置

参数示例:

{
    "path":"/pages/index/index?id=***",
    "mini_id":"wx9e47aa0184e1****"
}

platfrom_type为5(小程序-Urlscheme版):

  • msg: 小程序配置

参数示例:

{
    "path":"/pages/index/index?id=***",
    "mini_id":"wx9e47aa0184e1****",
    "original_id":"gh_d62b520f****"
}

platfrom_type为6(小程序-点击版)

  • msg: 小程序配置

参数示例:

{
    "path":"/pages/index/index?id=***",
    "mini_id":"wx9e47aa0184e1****"
}

platfrom_type为2、3(微信客服):

  • msg: 客服配置

注意: 客服采用回复类型; 每次用户进入均会发送第一条内容,当所有内容发送完毕则一直发送最后一条内容。

参数示例:

[
    {"type":1,"text":"欢迎使用天天外链引流到微信客服测试,请回复【任意内容】查看图文示例。更多<a href="https://nilife.cn">查看官网</a>!"},
    {"type":3,"text":{"title":"每日推广助手 - 微信营销增长变现一体化平台!","description":"每日推广助手提供知乎,百度,今日头条,短信等直接跳转公众号;多款微信营销工具、微信个人收款码、微信付费文章等多种微信私域流量变现平台。","url":"https://nilife.cn/","thumb_url":"https://****/1615808602931788vxm14m.png"}},
    {"type":2,"text":"https://****/16158092553572jhssbaf5e.jpg"},
    {"type":1,"text":"全部体验完成,如有疑问请联系客服。"}
]


更多相关文章