# 移动应用调用服务市场接口

微信服务市场提供的部分增值能力接口,不仅可被公众号和小程序调用,亦可以被移动应用调用,详情可参考如下指引。

# 第一步:创建应用

请到“管理中心”创建应用,点击“创建移动应用”,填写相关资料,然后将该应用提交审核,只有审核通过的应用才能进行开发。

注册完毕,我们会在 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" : "xxxxx",
  "api" : "xxxx",
  "data" : {
    xxxxxxxx
  },
  "client_msg_id" : "id123"
}

# 返回数据示例

{
 "errcode": 0,
 "errmsg": "ok",
 "data": "xxxxxx"
}

# 服务ID和接口名

可通过如下方式找到服务id和接口名称