创建短链 - 爱短链开放平台API

请求参数

Query 参数

apikey

string

必需

接口调用令牌ApiKey

示例值:

8c1331250ede960fd51ac56a829cc6893ce8c000

Body 参数application/json

target_url

string

跳转目标链接

必需

必须以 http:// 或 https:// 开头的链接

group_id

integer

短链分组id

可选

获取短链分组接口中获取，不填则默认使用账号的首个分组

示例值:

123

domain

string

专属域名或域名列表中的域名id

可选

chain_title

string

短链标题

可选

不填则默认为'未命名'

示例值:

链接标题

valid_time

string

短链到期时间

可选

不传即为永久有效

示例值:

2024-01-01 21:09:11

示例

{
  "target_url": "https://www.baidu.com",
  "chain_title": "测试添加123",
  "group_id": 1035,
  "domain": 6357,
  "valid_time": ""
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://openapi.aifabu.com/v1/chain/createChain?apikey=8c1331250ede960fd51ac56a829cc6893ce8c000' \
--header 'Content-Type: application/json' \
--data-raw '{
  "target_url": "https://www.baidu.com",
  "chain_title": "测试添加123",
  "group_id": 1035,
  "domain": 6357,
  "valid_time": ""
}'

返回响应

🟢200成功

application/json

Body

code

integer

返回的状态码

必需

code为1代表接口处理成功

msg

string

返回的状态信息

必需

result

object

返回的数据

必需

group_id

integer

分组 id

必需

render_url

string

短链接网址

必需

chain_title

string

链接标题

必需

created_today

integer

今日已创建的短链数量

必需

示例

{
    "code": 1,
    "msg": "创建成功！",
    "result": {
        "group_id": 373,
        "render_url": "http://test.demo.cn/test12",
        "chain_title": "链接标题",
        "created_today": 1
    }
}