短key托管类似于短链API,开发者可以通过GenShorten将不超过4KB的长信息转成短key,再通过FetchShorten短key还原为长信息

GenShorten

http请求方式: POST https://api.weixin.qq.com/cgi-bin/shorten/gen?access_token=ACCESS_TOKEN

参数说明

参数 是否必须 类型 说明
access_token string 调用接口凭证
long_data string 需要转换的长信息,不超过4KB
expire_seconds uint32 过期秒数,最大值为2592000(即30天),默认为2592000

错误码

错误码 说明
44002 POST Data为空
47001 POST数据格式错误
47003 参数错误(没有传入long_data)
9410010 long_data长度超过限制
9410011 expire_seconds超过限制
-1 系统错误

调用举例

 curl 'https://api.weixin.qq.com/cgi-bin/shorten/gen?access_token=ACK' -d '{"long_data":"loooooong data", "expire_seconds": 86400}'

返回说明 正常情况下,会返回下述JSON:

{
  "errcode": 0,
  "errmsg": "ok",
  "short_key": "iTqRJFSEqk9RvPk"
}

参数说明

参数 说明
short_key 短key,15字节,base62编码(0-9/a-z/A-Z)

FetchShorten

http请求方式: POST https://api.weixin.qq.com/cgi-bin/shorten/fetch?access_token=ACCESS_TOKEN

参数说明

参数 是否必须 类型 说明
access_token string 调用接口凭证
short_key string 短key

错误码

错误码 说明
44002 POST Data为空
47001 POST数据格式错误
47003 参数错误(没有传入short_key)
9410012 传入的short_key不存在,或者已过期,或者不属于本账号
-1 系统错误

调用举例

 curl 'https://api.weixin.qq.com/cgi-bin/shorten/fetch?access_token=ACCESS_TOKEN' -d '{"short_key": "iTqRJFSEqk9RvPk"}'

返回说明 正常情况下,会返回下述JSON:

{
  "errcode": 0,
  "errmsg": "ok",
  "long_data": "loooooong data",
  "create_time": 1611047541,
  "expire_seconds": 86300
}

参数说明

参数 说明
long_data 长信息
create_time 创建的时间戳
expire_seconds 剩余的过期秒数