什麼是SPI

• 服務商提供介面（Service Provider Interface）
  • API：平台提供介面並實現，您來呼叫
  • SPI：平台提供標準，您來實現，可以有多個實作方

SPI進駐流程

• 首先，您得有一個擁有「三方應用程式」標籤的APP。點
  這裡
  • 進行申請。
  • 申請成功後，進入這個應用程式的控制台，就能看見「API服務提供」選單
#注意：在概覽裡可以看見目前應用的AppKey和AppSecret。

• SPI呼叫方需要在TargetAppkey填寫這個AppKey，才能調到您實作的服務；

進入場景後可見到場景中的所有待實現的API，請見下圖。

• 请求方法：POST 或 GET;
• 请求编码：UTF-8 或 GBK；
• 公共请求参数、业务请求参数以及响应参数要与文档完全一致。返回值可参考返回示例；
• 异常处理：按照这里的规范返回指定的字段，开放平台藉此判断您的返回是成功或失败；
• 请求示例：可使用这里的示例替换上您的参数，测试您实现的服务。注意，这个方法对排查错误非常有用。

服务开发

服务开发完成是您自主研发的过程，您只需要严格按照文档中的协议进行开发即可。开发语言、部署环境都没有特别的要求。

为了安全，我们强烈建议您的服务要验证签名以及验证请求方的IP。为了方便您的开发，我们有SDK提供给你，SDK下载页面请看下图。

签名校验

必选！验签的目的是防止黑客恶意调用你的服务，确保服务发起来源是阿里平台。

目前验签方法只提供了JAVA、PHP、.NET三个版本的SDK，其它语言需要自行实现。

签名方法生成规则是：

• 将query参数、header参数存入一个map中备用。为了方便说明，这个map取名为params。注意：query中的sign参数不能放入params；
• 如果body中的类型是form-data，将body中的所以除文件以外的参数放入params。因为一些技术原因，通过form-data传递的文件不进行签名；
• 如果body中的类型是json或xml，暂时将body保存起来后面备用。为了方便说明 ，这段内容取名为body；
• 将params进行按key的字母先后顺序排序，然后遍历它，按key1 value2 key2 value2……的方式形成一个字符串，为了方便说明，后续称之为签名串。如果value为空，则用””来代替。如果body不为空，则在签名串最后增加body的所有内容；
• 在签名串的头和尾加上secret。这个secret是sp申请应用时获得的。至此，签名串生成好了；
• 对签名串进行md5以及hex，最后得到sign。总结一下，生成sign的公式是：
  hex(md5(secret sorted(header_params url_params form_params) body) secret)
• 最后，将生成的sign与从query中获取到的sign进行对比，即可校验签名的正确性。

验签示例代码如下：