调用方法详解 - 货拉拉开放平台

调用方法详解(待上线)

1.货拉拉API调用
货拉拉开放平台是基于HTTP协议调用的，开发者(ISV)可以需封装为HTTP请求来进行调用。接下来会针对自行封装的HTTP请求进行API调用过程进行详细说明。

2.调用流程

开发者需要按照协议规范拼装一个正确的URL，通过Https请求到货拉拉开放平台获取到所需数据。主要流程包含：填写参数、生成签名、拼装HTTPS请求、发起请求、得到响应结果、解析结果。

3.调用入口

沙箱环境服务入口: https://openapi-pre.huolala.cn/v1

生产环境服务入口: https://openapi.huolala.cn/v1

4.调用参数:

参数可区分为“系统级参数”和“业务参数”

5.签名说明:

调用API时需要对请求参数进行签名，货拉拉网关服务器端会验证请求参数是否正确。

签名算法请参照“签名算法”。

6.请求示例:

需授权接口调用示例。

     {
         "api_method":"xxxxxxx",          //接口方法名
         "api_version":"1.0",             //接口版本号
         "app_key":"xxxxxxx",             //应用app_key
         "access_token":"xxxxxxxxxxx",    //用户授权访问令牌
         "timestamp":"xxxxxxx",           //请求时间戳,仅用于保证请求不可重复(unix时间戳,单位秒)
         "nonce_str":"xxxxxxx",           //随机数
         "signature":"xxxxxx",            //签名值
         "api_data":"{                     //业务数据封装json字符串
             \"city_id\":1002
         }"
     }

不需要授权接口调用示例。

     {
         "api_method":"xxxxxxx",          //接口方法名
         "api_version":"1.0",             //接口版本号
         "app_key":"xxxxxxx",             //应用app_key
         "timestamp":"xxxxxxx",           //请求时间戳,仅用于保证请求不可重复(unix时间戳,单位秒)
         "nonce_str":"xxxxxxx",           //随机数
         "signature":"xxxxxx",            //签名值
         "api_data":"{                     //业务数据封装json字符串
             \"city_id\":1002
         }"
     }