生成Link
收藏接口说明
该接口用于生成能够直接跳转到端内小游戏的 url link。
使用限制
该接口设定有频次控制，每个小游戏，100qps，50w次/自然日。如有特殊需求联系oncall。
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://minigame.zijieapi.com/mgplatform/api/apps/url_link/generate |
| HTTP Method | POST |
| Scope | open.ttgame.mgplatform |
| 权限要求 | URL Link相关api |
请求参数
请求头
access-token必填String
示例：08011218462b6b4b5054626e426e50685a7554643144644449413d3d
content-type必填String
固定值"application/json"
Body
app_name必填String
宿主名称
expire_timeInt64
失效时间
queryString
query（json形式）
version_typeString
小游戏版本
请求示例
curl --location --request POST 'https://minigame.zijieapi.com/mgplatform/api/apps/url_link/generate' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \ --data '{ "app_name": "douyin", "query": "{\"page\":\"abc\",\"type\":6}", "expire_time": 1749520800, "version_type": "current" }'
响应参数
Body展开全部子属性
err_msg必填String
错误信息
err_no必填Int32
错误码
log_id必填String
日志id
dataStruct
详细信息
展开子属性
响应示例
正常响应示例异常响应示例
{ "BaseResp": { "StatusCode": 0, "StatusMessage": "" }, "data": { "url_link": "https://l.douyin.com/7i9NPQN" }, "err_msg": "", "err_no": 0, "log_id": "202505272110409E7071F616BEEB9A05F1" }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 0 | 成功 | |
| 200 | 28001005 | 系统错误 | |
| 200 | 28001007 | 参数不合法 | |
| 200 | 28001003 | access_token无效 | |
| 200 | 28001019 | 权限被封禁 | |
| 200 | 28005017 | schema编码异常 | |
| 200 | 28005014 | 到期时间不在范围内 | |
| 200 | 28005016 | 生成URL_Link频率过快 | |
| 200 | 28005018 | 生成URL_Link数量超过上限 |
