API调用方法详解

开放平台的API是基于HTTP协议来调用的,可以根据协议来封装HTTP请求进行调用，以下主要是针对自行封装HTTP请求进行API调用的原理进行详细解说。

#调用流程

根据协议：填充参数 > 生成签名 > 拼装HTTP请求 > 发起HTTP请求> 得到HTTP响应 > 解释json结果，以下是大体的调用过程示意图：

#调用入口

调用API的服务URL地址，开放平台目前提供了2个使用环境：测试环境，正式环境。

测试环境：开发者软件测试接口时的测试环境，通过测试地址获取测试数据，并调试代码。

正式环境：客户蔬东坡生鲜供应链系统的正式环境，通过正式环境可以获取到客户的正式数据。

调用环境	服务地址	说明
测试环境	http://scm.sdongpo.com/cc_thirdparty	蔬东坡的内部测试系统
正式环境	http://scm.sdongpo.com/cc_xxx	xxx代表客户的正式环境的项目code
#公共参数
参数名	必选	类型
:----	:---	:-----
appid	是	string
timestamp	是	int
sign	是	string
notice	否	string
site_id	否	string
#业务参数

API调用除了必须包含公共参数外，如果API本身有业务级的参数也必须传入，每个API的业务级参数请看接口文档说明。

api使用签名+时间戳鉴权

请求api接口格式：
/openApi/commodity/list?appid=xxx&sign=12AA12SD123SD1DSSA&timestamp=1511332935&notice=3wfw3&key1=value1&key2=value2...

appid: 由服务端分配唯一标示appid

timestamp：当前时间戳

sign：签名(32位)