容器服务
TOP SPI说明文档
更新时间：2018/08/28
访问次数：29997
简述
为了保护某些敏感的数据的安全性，我们提供了一套全新的接口请求方式：SPI。目前已开放的接口有购物车回调、手淘专用红包发放等，后续会有更多的接口会通过这种方式开放。
术语约定
- SPI ：一种淘宝和三方服务器间通信机制，常见的使用方式，由淘宝定义服务接口，三方提供服务实现（一个可访问的回调地址）。
- 场景 ：一组spi接口的集合，spi的权限管理单位。
- 回调地址：SPI服务的实现。一个可访问的http链接，请求格式中的query和body参数由“SPI接口文档”的入参说明，响应的格式需要符合“SPI接口文档”的出参说明。
SPI接口开发基础流程
Step 1、获取SPI场景使用入口权限
把互动应用后台appkey提供给SPI的发布人，星睿；
注：“购物车回调”，“颁发onecode”两个场景已经默认开放，无需此步骤
Step 2、到TOP后台确认是否开通
（例如：http://my.open.taobao.com/spi/groups.htm?appkey=23025543&app_id=1744060 ）
Step 3、申请场景开发
申请之后，需要主动通知一下SPI提供者（星睿；）进行审批。
Step 4、找到SPI场景的开发入口
在TOP控制台“我的场景”，点击进入开发
Step 5、配置回调地址
点击“开发测试”，进入页面后配置自己的后台页面地址，该页面地址用来接收 数据请求
Step 6、SPI服务开发（含源代码）
开始页面开发，比如测试页面链接
http://jiuxianphone-1.play.admin.jaeapp.com/spiCart.jsp
页面格式输出格式（json或者xml）以及页面输出参数需要参照场景开发文档。
页面JSP示例代码如下：
<%@ page contentType="application/json; charset=UTF-8" %>
<%
response.setContentType("text/xml");
%>
<recieved>true</recieved>
账号：b2ctest17@yahoo.cn 密码：sxc50113891
页面PHP示例代码如下：待补充。
Step 7、确认是否能收到消息
坐等接收请求，程序需要有servlet来处理该Http get请求，TOP会发送一条以下格式的Http get请求（以购物车接口为例）：
Step 8、校验请求真实性（验签）
验签代码SignUtil中的secret字段需要根据应用配置填写。
- Java方式：
sdk中提供了用于验签的util工具类：
com.taobao.api.internal.spi.SpiUtils#checkSign4TextRequest
使用中的疑问咨询
广陵
- PHP方式：
需要按照TOP API调用说明中的签名生成算法自行实现
Step 9、提交上线申请
