创建微信外链

POST/v1/chain/createWxChain?apikey=8c1331250ede960fd51ac56a829cc6893ce8c000

:::highlight yellow 💡

创建链接条数限制：关联VIP权限，具体条数请参照服务定价；
::: 调用此接口前，请先调用以下接口，获取关键参数值：获取 *group_id*：[获取链接分组](apifox://link/endpoint/226015023) 获取 *domain*：[用户可选域名列表](apifox://link/endpoint/226080379)（*domain_list.id*）获取 *channel_list*、*avatar*：[上传二维码/素材图片](apifox://link/endpoint/226098516) 获取 *jump_template_id*：[获取跳转页模板列表](apifox://link/endpoint/226111320)（*list.id*）

请求参数

Query 参数

apikey

string

必需

接口调用令牌ApiKey

示例值:

8c1331250ede960fd51ac56a829cc6893ce8c000

chain_type

enum<integer>

链接类型

必需

枚举值:

示例值:

jump_template_id

integer

跳转页模板id

必需

0为通用模板

示例值:

is_direct_jump

enum<integer>

跳转页是否直接跳转

必需

枚举值:

示例值:

chain_title

string

链接备注

可选

<= 32 字符

默认值:

未命名

qrcode_vc_type

enum<integer>

二维码访问上限类型

必需

枚举值:

示例值:

group_id

string

分组id

必需

示例值:

111

domain

integer

域名id

必需

示例值:

123

show_type

enum<integer>

二维码展示页类型

必需

枚举值:

示例值:

scan_tips

enum<integer>

扫码引导提示

必需

结合show_type字段使用

枚举值:

示例值:

avatar

string

推广头像

可选

show_type为1时生效

示例值:

xxx/xxx/1729760546_70150213689864071744

sub_title

string

二维码页推广副标题

可选

show_type为1时生效

<= 20 字符

示例值:

副标题内容

desc

string

推广标题

可选

show_type为1时生效

visit_type

enum<integer>

二维码切换方式

必需

枚举值:

1345

示例值:

channel_list

array [object {8}]

二维码图片list

必需

visit_limit

integer

二维码访问次数上限

必需

示例值:

9999

qrcode_name

string

二维码文件名

必需

示例值:

文件原始名称.png

qrcode_time

integer

二维码有效期

必需

时间戳格式

示例值:

1792831296

sort

integer

二维码展示优先级

必需

数字越小，优先级越高

>= 1<= 200

示例值:

url

string

二维码文件上传成功后的文件名称

必需

示例值:

1729761919_70418148801369350000

url2

string

二维码文件上传成功后的图片链接

必需

示例值:

https://xxx.xxx.com/xxx/xxx/1729761919_70418148801369350000

ratio

integer

跳转比例

必需

visit_type为3时生效

示例值:

status

enum<integer>

二维码展示状态

必需

枚举值:

示例值:

{
  "chain_type": "2",
  "show_type": 2,
  "applet_type": 1,
  "sub_title": "",
  "jump_template_id": 0,
  "is_direct_jump": 1,
  "chain_title": "链接备注",
  "qrcode_vc_type": 1,
  "scan_tips": 1,
  "avatar": "",
  "visit_type": 5,
  "group_id": "988",
  "desc": "",
  "domain": 6357,
  "channel_list": [
    {
      "visit_limit": 99999,
      "qrcode_name": "微信.jpg",
      "qrcode_time": 1792813575,
      "sort": 1,
      "url": "1729741574_91057932051485428813",
      "url2": "https://xxx.xxx.com/1729741574_91057932051485428813",
      "ratio": 1,
      "status": 1
    }
  ]
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

code

integer

返回的状态码

必需

code为1代表接口处理成功

msg

string

返回的状态信息

必需

result

object

返回的数据

必需

render_url

string

创建的链接

必需

chain

string

创建的链接后缀

必需

{
  "code": 1,
  "msg": "创建成功！",
  "result": {
    "render_url": "http://dev.d4t.cn/XR78PM",
    "chain": "XR78PM"
  }
}

最后修改时间： 4 个月前