微信服务市场提供的增值能力接口,不仅可被公众号和小程序调用,亦可以被移动应用调用,详情可参考如下指引。
# 第一步:创建应用
请到“管理中心”创建应用,点击“创建移动应用”,填写相关资料,然后将该应用提交审核,只有审核通过的应用才能进行开发。
注册完毕,我们会在 7 个工作日内完成审核工作。审核通过之后,开放平台将分配给该移动应用全局唯一的 AppID 和 AppSecret。
# 第二步:根据 AppID 和 AppSecret 获得 access token
# 调用接口:
GET https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET
# 参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
grant_type | 是 | 获取 access_token 填写 client_credential |
appid | 是 | 应用的 appid |
secret | 是 | 应用的 appsecret |
# 返回说明:
正常情况下,微信会返回下述 JSON 数据包。
{
"access_token": "ACCESS_TOKEN",
"expires_in": 7200
}
参数 | 说明 |
---|---|
access_token | 获取到的凭证 |
expires_in | 凭证有效时间,单位:秒 |
错误时微信会返回错误码等信息,JSON 数据包示例如下(该示例为 AppID 无效错误):
{
"errcode": 40013,
"errmsg": "invalid appid"
}
# 第三步:使用 access token 调用服务市场接口
# 输入说明:
POST https://api.weixin.qq.com/wxa/servicemarket?access_token=ACCESS_TOKEN
# 请求参数
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
access_token | string | 是 | 第二步中获得的access_token | |
service | string | 是 | 服务 ID,在每个接口详情页面中均可以找到服务id,请查看文档末尾截图 | |
api | string | 是 | 接口名;在每个接口详情页面中均可以找到api name,请查看文档末尾截图 | |
data | string | 是 | 服务提供方接口定义的 JSON 格式的数据 | |
client_msg_id | string | 是 | 随机字符串 ID,调用方请求的唯一标识 |
# 返回值
# Object
返回的 JSON 数据包
属性 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
data | string | 回包信息 |
# 请求数据示例
{
"service" : "wx79ac3de8be320b71",
"api" : "OcrAllInOne",
"data" : {
"img_url": "http://mmbiz.qpic.cn/mmbiz_jpg/7UFjuNbYxibu66xSqsQqKcuoGBZM77HIyibdiczeWibdMeA2XMt5oibWVQMgDibriazJSOibLqZxcO6DVVcZMxDKgeAtbQ/0",
"data_type": 3,
"ocr_type": 1
},
"client_msg_id" : "id123"
}
# 返回数据示例
{
"errcode": 0,
"errmsg": "ok",
"data": "{\"idcard_res\":{\"type\":0,\"name\":{\"text\":\"abc\",\"pos\"…0312500}}},\"image_width\":480,\"image_height\":304}}"
}
# 服务ID和接口名
可通过如下方式找到服务id和接口名称