# 查询加密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 配置

属性	类型	说明
appid	string	小程序 appid
path	string	小程序页面路径
query	string	小程序页面query
create_time	number	创建时间，为 Unix 时间戳
expire_time	number	到期失效时间，为 Unix 时间戳，0 表示永久生效
env_version	string	要打开的小程序版本。正式版为"release"，体验版为"trial"，开发版为"develop"

quota_info

object

quota 配置

	属性	类型	说明
	remain_visit_quota	number	URL 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不存在