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和接口名称