创建微信外链

POST

https://openapi.aifabu.com/v1/chain/createWxChain

💡

创建链接条数限制：关联VIP权限，具体条数请参照服务定价；

准备事项

调用此接口前，请先调用以下接口，获取关键参数值：

获取 group_id：获取链接分组

获取 domain：用户可选域名列表（domain_list.id）

获取 channel_list、avatar：上传二维码/素材图片

获取 jump_template_id：获取跳转页模板列表（list.id）

请求参数

Query 参数

apikey

string

必需

接口调用令牌ApiKey

示例值:

8c1331250ede960fd51ac56a829cc6893ce8c000

Body 参数application/json

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
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://openapi.aifabu.com/v1/chain/createWxChain?apikey=8c1331250ede960fd51ac56a829cc6893ce8c000' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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成功

application/json

Body

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"
    }
}

修改于 2024-11-01 08:21:56

获取跳转页模板列表

编辑微信外链