查询SchemaV2
收藏接口说明
该接口用于查询已经生成的 schema 的信息。
查询已经生成的 schema 的信息，过期的 schema 返回 12023(schema 不存在或已失效)。
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | |
| HTTP Method | POST |
| Scope | ma.share.schema |
| 权限要求 | 需要小程序通过试运营期 |
请求参数
请求头
access-token必填String
示例：clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
示例：application/json
固定值"application/json"
Body
app_id必填String
示例：tt*******
小程序ID
schema必填String
示例：sslocal://miniapp?ticket=v1_********
生成的schema
请求示例
curl --location 'https://open.douyin.com/api/apps/v1/url/query_schema/' \ --header 'access-token: clt.01********3d3d' \ --header 'Content-Type: application/json' \ --data '{ "schema":"sslocal://miniapp?ticket=v1_*****", "app_id":"tt*****" } '
响应参数
Body展开全部子属性
dataStruct
展开子属性
err_msgString
示例：""
err_noInt32
示例：0
log_idString
示例：202008121419360101980821035705926A
响应示例
正常响应示例异常响应示例
{ "data": { "app_id": "tt******", "path": "page/index", "query": "{}", "create_time": 1682075227, "expire_time": 0 }, "err_msg": "", "err_no": 0, "log_id": "2023********7AB1" }
错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 0 | 成功 | |
| 200 | 28005015 | 权限被封禁 | 权限被封禁 |
| 200 | 28005002 | 内部错误 | 重试 |
| 200 | 28005077 | schema不存在或已失效 | schema不存在或已失效 |
| 200 | 28001003 | access_token无效 | 重新获取access_token |
