查询SchemaV2

开发环境

http://dev-cn.your-api-server.com

POST

/api/apps/v1/url/query_schema/

查询已经生成的 schema 的信息，过期的 schema 返回 12023(schema 不存在或已失效)。
权限要求：需要小程序通过试运营期

错误码

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

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

🟠400请求有误

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://dev-cn.your-api-server.com/api/apps/v1/url/query_schema/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "schema":"sslocal://miniapp?ticket=v1_*****",
    "app_id":"tt*****"
}'

响应示例

200 - 成功示例

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

修改于 2025-11-07 09:22:55

生成SchemaV2

查询Schema配额V2

查询SchemaV2

错误码#

请求参数

返回响应

错误码