天天外链API对接文档

1个评论 • 2021-03-16 13:03:52

天天外链支持小程序、APP、API、后台创建管理外链；浏览器/QQ/短信/邮件/知乎/今日头条等点击链接即可跳转微信公众号、微信客服。

声明：为了避免洗钱、套现等非法风险；天天外链无法为金融、支付跳转提供服务，创建此类型链接我们会禁用您的推广账户；感谢您的理解与支持。

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

基础链接与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: 子类型
- 1.公众号文章（platfrom为1）
- 2.公众号二维码（platfrom为3）
- 3.个人二维码（platfrom为3）
- 4.小程序(密钥版)（platfrom为2）
- 5.小程序(Urlscheme版)（platfrom为2）
- 6.小程序(点击版)（platfrom为2）
urlscheme：小程序urlscheme(platfrom_type为5时有效)
notice：提示类型(platfrom_type为2、3、6时有效)
- 1.点击咨询
- 2.点击进群
- 3.立即领取
- 4.领取福利
- 5.点这里
notice_img：提示图片(platfrom_type为2、3、6时有效)
describe_show：是否显示按钮(platfrom_type为2、3、6时有效)
- 1.显示
- 2.不显示
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: 子类型
- 1.公众号文章（platfrom为1）
- 2.公众号二维码（platfrom为3）
- 3.个人二维码（platfrom为3）
- 4.小程序(密钥版)（platfrom为2）
- 5.小程序(Urlscheme版)（platfrom为2）
- 6.小程序(点击版)（platfrom为2）
urlscheme：小程序urlscheme(platfrom_type为5时有效)
notice：提示类型(platfrom_type为2、3、6时有效)
- 1.点击咨询
- 2.点击进群
- 3.立即领取
- 4.领取福利
- 5.点这里
notice_img：提示图片(platfrom_type为2、3、6时有效)
describe_show：是否显示按钮(platfrom_type为2、3、6时有效)
- 1.显示
- 2.不显示
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: 小程序配置
- mini_id: 小程序APPID
- path: 跳转路径
  - 为空: 跳首页且微博无法跳转
  - 自定义参数：支持路径加参数,例（/pages/index/test?id=1&users=1）

参数示例:

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

platfrom_type为5（小程序-Urlscheme版）：

msg: 小程序配置
- mini_id: 小程序APPID
- path: 跳转路径,若为空（跳首页且微博无法跳转）
- original_id：小程序原始ID,若为空（微信无法跳转）

参数示例:

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

platfrom_type为6（小程序-点击版）

msg: 小程序配置
- mini_id: 小程序APPID
- path: 跳转路径,若为空跳首页

参数示例:

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

platfrom_type为2、3（微信客服）：

msg: 客服配置
- type: 类型(1.文本2.图片3.图文)
- text: 对应参数
  - text(type为1): 文本,可使用A标签添加链接
  - text(type为2): 图片链接
  - text(type为3): 图文信息(title:标题,description:描述,url:点击跳转链接,thumb_url:图片地址)

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

参数示例:

[
    {"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":"全部体验完成，如有疑问请联系客服。"}
]