天天外链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,请求方法为POST，from-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,请求方法为POST，from-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":"全部体验完成，如有疑问请联系客服。"}
]

天天外链