编辑微信外链

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

:::highlight yellow 💡

调用次数限制：3000次/天；
调用频率限制为：5次/秒；
:::

调用此接口前，请先调用以下接口，获取关键参数值：获取 *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

string

链接后缀

必需

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

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

必需

integer

图片id

必需

示例值:

111

visit_limit

integer

二维码访问次数上限

必需

示例值:

9999

qrcode_name

string

二维码文件名

必需

示例值:

文件原始名称.png

qrcode_time

integer

二维码有效期

必需

时间戳格式

示例值:

1792831296

sort

integer

二维码展示优先级

必需

数字越小，优先级越高

>= 1<= 200

示例值:

url

string

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

必需

示例值:

1729761919_70418148801369350000

ratio

integer

跳转比例

必需

visit_type为3时生效

示例值:

status

enum<integer>

二维码展示状态

必需

枚举值:

示例值:

{
  "chain": "qweqwe",
  "chain_type": "2",
  "show_type": 2,
  "applet_type": 1,
  "sub_title": "",
  "is_direct_jump": 1,
  "jump_template_id": 0,
  "chain_title": "最新的openApi-编辑",
  "bind_device": 1,
  "qrcode_vc_type": 1,
  "scan_tips": 1,
  "avatar": "",
  "desc": "",
  "visit_type": 5,
  "group_id": "988",
  "channel_list": [
    {
      "id": 111,
      "visit_limit": 99999,
      "qrcode_name": "XXX.jpg",
      "qrcode_time": 1792813575,
      "sort": 1,
      "url": "1729741574_9105793205148000000",
      "ratio": 1,
      "status": 1
    }
  ]
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

code

integer

返回的状态码

必需

code为1代表接口处理成功

msg

string

返回的状态信息

必需

result

array[string]

返回的数据

必需

{
  "code": 1,
  "msg": "编辑成功！",
  "result": []
}

最后修改时间： 4 个月前