# invokeService
该接口用于调用服务平台上架的api,适用于公众号、小程序和第三方平台调用,区别仅仅在于access_token的生成而已。
# HTTPS 调用
# 请求地址
POST https://api.weixin.qq.com/wxa/servicemarket?access_token=ACCESS_TOKEN
# 请求参数
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
access_token | string | 是 | 如果是公众号,则参考Get_access_token;如果是小程序,则参考auth.getAccessToken;如果是第三方平台调用,则参考authorizer_access_token | |
service | string | 是 | 服务 ID,在每个接口详情页面中均可以找到服务id,请查看文档末尾截图 | |
api | string | 是 | 接口名;在每个接口详情页面中均可以找到api name,请查看文档末尾截图 | |
data | string | 是 | 服务提供方接口定义的 JSON 格式的数据,请看每个服务的接口文档详情 | |
client_msg_id | string | 是 | 随机字符串 ID,调用方请求的唯一标识 | |
async | boolean | 否 | 是否是异步API,当是异步调用时,必须填true |
# 返回值
# Object
返回的 JSON 数据包
属性 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
data | string | 回包信息 |
request_id | string | 异步调用才会返回,唯一id |
# 同步请求数据示例
{
"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}}"
}
# 异步请求数据示例
{
"service" : "wxee446d7507c68b11",
"api" : "SecCheckAsync",
"data" : {
"BusinessType": 1,
"MediaType": 1,
"TextContent": "hello",
"MediaUrl": "http://example.com/example.jpg"
},
"client_msg_id" : "random_id_456",
"async" : true,
"client_msg_id" : "id123"
}
# 异步返回数据示例
{
"errcode": 0,
"errmsg": "ok",
"request_id": "MLwFmCkCxNOthxteVMf3UFWRmb9VPwTMTuxJUAUD-svS-6AqBC9tbzZzDyHFglQ5_aI"
}
# 错误码
错误码 | 英文描述 | 中文描述 |
---|---|---|
0 | ok | 成功 |
9301001 | 参数错误 | |
9301002 | call api service failed | 调用后端服务失败 |
9301003 | internal exception | 系统失败 |
9301010 | consumption failure | 配额不足 |
9301011 | 频率限制 | |
9301012 | 服务处理超时 | |
9301014 | RequestID | |
9301015 | 后端尚未处理完成 |
# 服务ID和接口名
可通过如下方式找到服务id和接口名称