1开发者归范-中南e行.docVIP

开发者归范 开发者接入 成为开发者 第一步： 在公众平台网站的高级功能–开发模式页，点击“成为开发者”按钮，填写URL和Token，其中URL是开发者用来接收掌上中南服务器数据的接口URL。Token可由开发者任意填写，用作生成签名（该Token会和接口URL中包含的Token进行比对，从而验证安全性） 第二步： 开发者提交信息后，掌上中南服务器将发送GET请求到填写的URL上，GET请求携带四个参数： 参数 描述 signature 掌上中南加密签名，signature结合了开发者填写的token参数和请求中的timestamp参数、nonce参数。 timestamp 时间戳 nonce 随机数 echostr 随机字符串 开发者通过检验signature对请求进行校验（下面有校验方式）。若确认此次GET请求来自掌上中南服务器，请原样返回echostr参数内容，则接入生效，成为开发者成功，否则接入失败。 加密/校验流程如下： 1. 将token、timestamp、nonce三个参数进行字典序排序 2. 将三个参数字符串拼接成一个字符串进行sha1加密 3. 开发者获得加密后的字符串可与signature对比，标识该请求来源于掌上中南 第三步 验证URL有效性成功后即接入生效，成为开发者。 基础支持 获取access_token access_token是公众号的全局唯一票据，公众号调用各接口时都需使用access_token。正常情况下access_token有效期为7200秒，重复获取将导致上次获取的access_token失效。由于获取access_token的api调用次数非常有限，建议开发者全局存储与更新access_token，频繁刷新access_token会导致api调用受限，影响自身业务。 公众号可以使用AppID和AppSecret调用本接口来获取access_token。AppID和AppSecret可在开发模式中获得（需要已经成为开发者，且帐号没有异常状态）。注意：所有掌上中南提供的接口需要采用https方式调用。 接口调用请求说明 http请求方式: GET HYPERLINK /mqtt/cgi-bin/token?grant_type=client_credentialappid=APPIDsecret=APPSECRET \t _blank /mqtt/cgi-bin/token?grant_type=client_credentialappid=APPIDsecret=APPSECRET 参数说明 参数 是否必须 说明 grant_type 是 获取access_token填写client_credential appid 是 第三方用户唯一凭证 secret 是 第三方用户唯一凭证密钥，即appsecret 返回说明 正常情况下，掌上中南服务器会返回下述JSON数据包给公众号： {access_token:ACCESS_TOKEN,expires_in:7200} 参数 说明 access_token 获取到的凭证 expires_in 凭证有效时间，单位：秒 错误时掌上中南服务器会返回错误码等信息，JSON数据包示例如下（该示例为AppID无效错误）: {errcode:40013,errmsg:invalid appid} 全局返回码说明 公众号每次调用接口时，可能获得正确或错误的返回码，开发者可以根据返回码信息调试接口，排查错误。 全局返回码说明如下： 返回码 说明 -1 系统繁忙 0 请求成功 40001 获取access_token时AppSecret错误，或者access_token无效 40002 不合法的凭证类型 40003 不合法的OpenID 40004 不合法的媒体文件类型 40005 不合法的文件类型 40006 不合法的文件大小 40007 不合法的媒体文件id 40008 不合法的消息类型 40009 不合法的图片文件大小 40010 不合法的语音文件大小 40011 不合法的视频文件大小 40012 不合法的缩略图文件大小 40013 不合法的APPID 40014 不合法的access_token 40015 不合法的菜单类型 40016 不合法的按钮个数 40017 不合法的按钮个数 40018 不合法的按钮名字长度 40019 不合法的按钮KEY长度 40020 不合法的按钮URL长度 40021 不合法的菜单版本号 40022 不合法的子菜单级数 40023 不合法的子菜单按钮个数 40024 不合法的子菜单按钮类型 40025 不合法的子菜单按钮名字长度 40026 不合法的子菜单按钮KEY长度 40027 不合法的子菜单按钮URL长度 400