使用说明
创建短链条数限制:关联VIP权限,初级会员50条/天,高级会员500条/天,企业会员10000条/天
请求
接口地址: https://openapi.bamuwu.com/v1/chain/createChain
请求方法: POST
请求参数说明
参数名 | 类型 | 是否必传 | 描述 |
---|
apikey | string | 是 | 用户的API密钥 |
target_url | string | 是 | 跳转链接,必须以 http:// 或 https:// 开头的链接 |
group_id | int | 否 | 分组id,获取短链分组接口中获取。不填则默认使用账号的首个分组。 |
chain_title | string | 否 | 短链标题,不填则默认为'未命名' |
domain | string | 否 | 专属域名,不填则默认为系统分配的域名 |
valid_time | date | 否 | 短链到期时间,例如2022-3-28 12:00:00,不传即为永久有效 |
可以在API设置中查看、重置APIKEY。
请求POST数据示例
{
"apikey": "1234567890abcdef123",
"target_url": "https://bamuwu.com",
"group_id": 1000,
"chain_title": "Baidu渠道"
}
返回参数说明
参数名 | 类型 | 描述 |
---|
code | int | 返回的状态码,详见状态码说明 |
msg | string | 返回状态信息 |
result | object | 返回的数据 |
group_id | array | 短链所属的分组id |
chain_title | string | 短链名称 |
target_url | string | 短链跳转地址 |
render_url | string | 短链地址 |
created_today | int | 今日已创建的短链数量 |
返回结果示例
{
"code": 1,
"msg": "success",
"result": {
"chain_title": "Baidu渠道",
"target_url": "https://baidu.com",
"render_url": "https://3durl.com/abcde0",
"group_id": 1000,
"created_today" : 101
}
}
状态码说明
状态码 | 描述 |
---|
1 | 返回数据成功 |
-1 | 返回数据失败 |
40001 | apikey错误 |
40002 | 请求参数错误 |
40003 | 短链错误 |
40004 | 权限不足 |