查询加密URLLink

查询加密URLLink

调试工具

接口应在服务器端调用，详细说明参见服务端API。

本接口支持云调用。需开发者工具版本 >= 1.02.1904090（最新稳定版下载），wx-server-sdk >= 0.4.0

接口说明

接口英文名

queryUrlLink

功能描述

该接口用于查询小程序加密 url_link 配置

调用方式

HTTPS 调用

POST https://api.weixin.qq.com/wxa/query_urllink?access_token=ACCESS_TOKEN 

云调用

• 出入参和HTTPS调用相同，调用方式可查看云调用说明文档
• 接口方法为: openapi.urllink.query

第三方调用

• 调用方式以及出入参和HTTPS相同，仅是调用的token不同
• 该接口所属的权限集id为：88、115
• 服务商获得其中之一权限集授权后，可通过使用authorizer_access_token代商家进行调用

请求参数

属性	类型	必填	说明
access_token	string	是	接口调用凭证，该参数为 URL 参数，非 Body 参数。使用access_token或者authorizer_access_token
url_link	string	否	小程序加密 url_link。
query_type	number	否	查询类型。默认值0，查询 url_link 信息：0， 查询每天剩余访问次数：1

返回参数

	属性	类型	说明
	errcode	number	错误码
	errmsg	string	错误信息
	url_link_info	object	url_link 配置
	属性类型说明appidstring小程序 appidpathstring小程序页面路径querystring小程序页面querycreate_timenumber创建时间，为 Unix 时间戳expire_timenumber到期失效时间，为 Unix 时间戳，0 表示永久生效env_versionstring要打开的小程序版本。正式版为"release"，体验版为"trial"，开发版为"develop"
	quota_info	object	quota 配置
	属性类型说明remain_visit_quotanumberURL Scheme（加密+明文）/加密 URL Link 单天剩余访问次数

调用示例

示例说明: 查询url_link

请求数据示例

{
    "url_link": "https://wxaurl.cn/BQZRrcFCPvg?cq=a%3Dhello",
    "query_type": 0
} 

返回数据示例

{
 "errcode": 0,
 "errmsg": "ok",
 "url_link_info": {
   "appid": "appid",
   "path": "",
   "query": "a=hello",
   "create_time": 611928113,
   "expire_time": 0,
   "env_version": "release",
   "cloud_base" : {
     "env": "",
     "doamin": "",
     "path": "",
     "query": "",     
     "resource_appid": ""
   }
 }
} 

示例说明: 查询剩余访问次数

请求数据示例

{
    "query_type": 1
} 

返回数据示例

{
 "errcode": 0,
 "errmsg": "ok",
 "quota_info": {
   "remain_visit_quota": 1000000
   }
 }
} 

示例说明: 云函数调用

请求数据示例

const cloud = require('wx-server-sdk')
cloud.init({
  env: cloud.DYNAMIC_CURRENT_ENV,
})
exports.main = async (event, context) => {
  try {
    const result = await cloud.openapi.urllink.query({
        "urlLink": 'https://wxaurl.cn/BQZRrcFCPvg'
      })
    return result
  } catch (err) {
    return err
  }
} 

返回数据示例

{
 "errcode": 0,
 "errmsg": "ok",
 "urlLinkInfo": {
   "appid": "appid",
   "path": "",
   "query": "",
   "createTime": 611928113,
   "expireTime": 0,
   "envVersion": "release",
   "cloudBase" : {
     "env": "",
     "doamin": "",
     "path": "",
     "query": "",     
     "resourceAppid": ""
   }
 }
} 

错误码

错误码	错误描述	解决方案
-1	system error	系统繁忙，此时请开发者稍候再试
40097	invalid args	参数错误
85403	not found	scheme/url link不存在