生活服务号API开发者接口文档(场景消息)1.02.pdf

生活服务号 API 接口文档 V1.02 2015 年 04 月 07 日 目录 总述 3 申请消息接口 3 接入申请验证 3 获取凭证 4 接口说明 4 QQ 号换 OpenId 接口 5 单发模板消息接口 6 统一错误码(后续待补充) 13 总述 本文档面向生活服务号平台的开发者，为生活服务号提供了一种新的消息处理模式，不依 赖 QQ 客户端，而是通过 API 与生活服务号平台进行交互，以获得更灵活的定制性和更强大 的消息推送能力。 生活服务号平台是为 QQ 生活服务号用户提供服务的平台，而生活服务号平台开发接口 则是提供服务的基础，开发者在生活服务号平台网站中创建生活服务号、获取接口权限后，可 以通过阅读本接口文档来帮助开发。 生活服务号平台开发接口为开发者提供与 QQ 用户进行消息交互、自定义菜单交互的能 力。对于成功接入生活服务号平台开发接口的互动账号，当 QQ 用户发消息给生活服务号 ， 生活服务号平台服务器会使用 http 请求对接入的网址进行消息推送，第三方服务器可通过响 应包回复特定结构，从而达到回复消息的目的。 申请消息接口 生活服务号用户目前需要在生活服务号平台开通开发者模式，开通时需要提供：开发者服务 的 URL 作为回调 URL。 开通后，生活服务号用户会得到 appid 和 appsecret ，appi 和 appsecret 一旦分配将不可 改变。此后的交互将依赖与这两个值，请开发者务必保持此 key 的安全性。 接入申请验证 开发者在生活服务号平台提交信息后，生活服务号服务器将发送GET 请求到填写的URL上， 并且带上四个参数： 参数 描述 Signature 加密签名 Timestamp 时间戳 Nonce 随机数 Echostr 随机字符串 开发者通过开发者通过检验 signature 对请求进行校验（下面有校验方式）。若确认此次 GET 请求来自营销 QQ 服务器，请原样返回 echostr 参数内容，则接入生效，否则接入失败。 signature 结合了开发者填写的 token 参数和请求中的 timestamp 参数、nonce 参数。 加密/校验流程： 1. 将 token、timestamp、nonce 三个参数进行字典序排序 2. 将三个参数字符串拼接成一个字符串进行 sha1 加密 3. 开发者获得加密后的字符串可与 signature 对比，标识该请求来源于生活服务账号平台。 获取凭证 如果第三方想主动调用接口，那么调用之前必须先获取到凭证 ，调用接口是把凭证作为参数 带上。凭证不用每次都获取，凭证获取之后会有一段时间的有效期 （120分钟）。 接口说明 在使用通用接口前，你需要做以下两步工作： 1. 获取到 appid 和 appsecret （在营销 QQ 账户中心接入申请验证通过后获得 ） 2. 通过获取凭证接口获取到 access_token 注意： access_token 是第三方访问 api 资源的票据； access_token 对应于营销 QQ 号是全局唯一的票据，重复获取将导致上次获取的 access_token 失效。 请求说明 https 请求方式：GET /cgi-bin/token?appid=APPIDsecret=APPSECRET 参数 是否必须 描述 APPID 是 第三方用户唯一凭证 APPSECRET 是 第三方用户唯一凭证密