查询SchemaV2__抖音开放平台

接口说明

该接口用于查询已经生成的 schema 的信息。

查询已经生成的 schema 的信息，过期的 schema 返回 12023(schema 不存在或已失效)。

基本信息

名称	描述
HTTP URL	正式地址：https://open.douyin.com/api/apps/v1/url/query_schema/ 沙盒地址：https://open-sandbox.douyin.com/api/apps/v1/url/query_schema/
HTTP Method	POST
Scope	ma.share.schema
权限要求	需要小程序通过试运营期

请求头

名称	字段类型	是否必填	示例	描述
access-token	String	是	clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ	调用https://open.douyin.com/oauth/client_token/生成的token
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

名称	字段类型	是否必填	示例
data	Struct	否
err_msg	String	否	""
err_no	Int32	否	0
log_id	String	否	202008121419360101980821035705926A

响应示例

正常响应示例

{
  "data": {
    "app_id": "tt******",
    "path": "page/index",
    "query": "{}",
    "create_time": 1682075227,
    "expire_time": 0
  },
  "err_msg": "",
  "err_no": 0,
  "log_id": "2023********7AB1"
}

异常响应示例

{
  "data": {},
  "err_msg": "access_token无效",
  "err_no": 28001003,
  "log_id": "2023******5ACF"
}

错误码

http状态码	错误码	错误码描述	排查建议
200	0	成功
200	28005015	权限被封禁	权限被封禁
200	28005002	内部错误	重试
200	28005077	schema不存在或已失效	schema不存在或已失效
200	28001003	access_token无效	重新获取access_token

查询SchemaV2在线调试

接口说明

基本信息

请求头

请求参数

Body

请求示例

响应参数

Body

响应示例

正常响应示例

异常响应示例

错误码

查询SchemaV2