微信认证接口文档.PDF

微信认证接口文档 v1.1 第一章 简介 RippleTek 微信认证服务 API 为开发者提供 HTTP 接口，即开发 者可通过发起包含 JSON 数据的 HTTP POST 请求，向 RippleTek 微 信认证服务器申请特定操作（认证 URL、上网验证码、取消认证和查 询用户OPENID ）。开发者可以使用此套API 定制开发基于 RippleTek 热点解决方案的微信认证管理。 第二章 获取认证链接 2.1 适用场景 开发者可通过该方法获取认证 URL ，执行此URL 可以完成用户 在微信中认证，开通上网权限。 2.2 服务地址 /Portal/Wx/get_auth_url 2.3 接口参数 输入参数： 参数名称 参数类型 参数描述 必选或者可选 api_id 字 符 串 请求认证 URL 的用户号。只能包含小写英文字符 必选 (String) 及数字，长度为 16 个字符。关于 api_id 和 api_key 的申请，请参见附录 II。 api_key 字 符 串 请求认证 URL 的用户密钥。只能包含小写英文字 必选 (String) 符及数字，长度为 32 个字符。关于 api_id 和 api_key 的申请，请参见附录 II。 node 整 数 需要认证节点的节点号。可通过节点查看看到自 必选 (Integer) 定义页面的节点号，还可通过节点配置API 获取。 openid 字 符 串 需要认证的微信用户 OPENID。 必选 (String) 注：1. 如果请求中包含任何上表中未列出的参数，这些未定义的参数将被 RippleTek 微信 认证服务器忽略。 2. 必选项不能为 null。 输出参数： 参数名称 参数类型 参数说明 status 整数 (Integer) 如果获取认证 URL 成功，返回 0 ；否则返回一个非零错误 代码。关于错误代码与错误信息的定义请参看附录 I。 auth_url 字符串 (String) 如果获取认证 URL 成功，返回认证 URL ，在对应节点的路 由器下可以认证成功，URL 有效期 10 分钟，之后 URL 失效， 若使用则会认证失败。 如果获取认证 URL 失败，则回复中不包含此参数。 err_msg 字符串 (String) 如果获取认证 URL 失败，此参数包含关于错误信息的详细描 述，关于错误代码与错误信息的定义请参看附录 I 。 如果获取认证 URL 成功，则回复中不包含此参数。 2.4 接口示例 请求示例 ： POST /Portal/Wx/get_auth_url { api_id:sJl7ufzuQCBlCFDn, api_key:7JCeAfUXrrXI95HZ/V2R7jmeZ3aZfdsJ, node: 12345, openid:oJZPgjhXBWcH_svRBQL2AxmjS-yM } 操作成功回复示例： {status:0,auth_url:/portal/wx/wechat_login/nodeId /4543/token/m4033926869} 操作失败回复示例： {status:-1,err_msg:Bad request! Please validate the JSON format of your request.} 第三章 获取上网验证码 3.1 适用场景 开发者可通过该方法获取上网验证码 ，在未开通微信的电脑上可 以通过输入验证码完