生成 Link V2
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/api/apps/v1/url_link/generate
使用限制
接口说明
错误码
需要以表格形式提供完整的错误码信息，表格中必须包含 HTTP 状态码、错误码、描述 和 排查建议 4 项。 描述在代码中是英文，这里建议换行补充对应的中文描述，方便开发者理解。
| HTTP 状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 200 | 28005001 | 参数解析失败 | 参数解析失败，请检查参数格式 |
| 200 | 28005014 | 到期时间不在范围内 | 到期时间不在范围内 |
| 200 | 28001003 | accesstoken过期或无权限 | 重新获取access_token，见client_token获取说明 |
| 200 | 28005015 | 权限被封禁 | 权限被封禁 |
| 200 | 28005017 | schema编码异常 | 请检查参数格式 |
| 200 | 28005016 | 生成URL_Link频率过快 | 生成URL_Link频率过快 |
| 200 | 28005018 | 生成URL_Link数量超过上限 | 生成URL_Link数量超过上限 |
| 200 | 28005022 | 链接生成失败，联系开发人员 | 链接生成失败，联系开发人员 |
| 200 | 28005002 | 系统异常 | 重试 |
请求参数
Body 参数application/json
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/api/apps/v1/url_link/generate' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"app_id":"tt********",
"app_name":"douyin",
"path":"xxxx",
"query":"{xxx:xxxx}",
"expire_time":1644464021,
}'响应示例响应示例
200 - 成功示例
{
"err_no": 0,
"err_msg": "",
"data": {
"url_link": "https://z.douyin.com/Lu86lrX"
}
}
修改于 2025-11-07 09:23:29