• 如果没有开发者账号，请成为开发者
• 如果已有开发者账号，请先登录，并进入到管理中心

• 所有接口都采用HTTP协议
• 所有接口都采用POST方式（包括查询接口）
• 请求和响应的数据都为JSON格式。注：请设置Header的Content-Type为application/json
• 采用UTF-8字符编码
• 所有的接口必须app_secret进行接口签名，规则见接口签名规则

API请求参数说明

注：所有的API接口都包含如下参数（不同的接口只是参数body值不一样）：

{{ developmentNotes_exampleCode }}

API响应结果说明

{{ developmentNotes_responseSuccessCode }}

{{ developmentNotes_responseFailCode }}

• 线上域名：{{ prodDomain }}

• 签名生成的通用步骤如下：
• 第一步：对参数排序；将参与签名的参数按照键值(key)进行字典排序
• 第二步：拼接请求字符串；将排序过后的参数，进行key和value字符串拼接
• 第三步：拼接签名原文字符串；将拼接后的字符串首尾加上app_secret秘钥，合成签名字符串
• 第四步：生成签名串；对签名字符串进行MD5加密，生成32位的字符串
• 第五步：将签名生成的32位字符串转换为大写

• 以Java举例，假设签名的请求参数如下，其中涉及签名的app_secret假设为"abcdefg123"：

{{ signature_exampleCode }}

• 第一步：对参数排序

首先对所有请求参数按参数名的字典序（ ASCII 码）升序排序。注意：
1）只按参数名进行排序，参数值保持对应即可，不参与比大小；
2）按 ASCII 码比大小，如 originId要排在 order_id 后面，不是按字母表，也不是按数值。 用户可以借助编程语言中的相关排序函数来实现这一功能，如 JAVA 中的 TreeMap 函数。


{{ signature_javaExampleCode1 }}



• 第二步：拼接请求字符串

此步骤生成请求字符串。 将把上一步排序好的请求参数格式化成“参数名称参数值”的形式，如对 app_key 参数，其参数名称为 "app_key" ，
参数值为 "123456" ， 因此格式化后就为 app_key123456 。

app_key123456body{"order_id":"20170301000001","originId":"7334"}formatjsonsource_id73753timestamp1488363493v1.0



• 第三步：拼接签名原文字符串

此步骤生成签名原文字符串。
签名原文字符串由请求字符串和app_secret组成
签名原文串的拼接规则为：app_secret+请求字符串+app_secret


abcdefg123app_key123456body{"order_id":"20170301000001","originId":"7334"}formatjsonsource_id73753timestamp1488363493v1.0abcdefg123



• 第四步：生成签名串

此步骤生成签名串。
首先使用MD5对前面原文字符串进行签名
对生成签名字符串进行MD5加密。结果为：19b88a0dc87ed19d15e3ca01739f3436



• 第五步：将签名生成的32位字符串转换为大写

将md5加密后的字符串转换为大写，结果为：19B88A0DC87ED19D15E3CA01739F3436

• 注：生成最终的签名的字符串：19B88A0DC87ED19D15E3CA01739F3436作为请求参数的signature的值传入即可

{{ signature_javaExampleCode }}

public static void main(String[] args) {
      String test = "{\n" +
              "  \"body\": {\"orderNo\":\"0123050713524853465\",\"cancelReason\":\"不需要了\"},\n" +
              "  \"format\": \"json\",\n" +
              "  \"timestamp\": \"1488363493\",\n" +
              "  \"app_key\": \"1\",\n" +
              "  \"v\": \"v.10\",\n" +
              "  \"source_id\": \"1\"\n" +
              "}";

      JSONObject param = JSONObject.parseObject(test);
      String signature = getSignature(param, "1");
      System.out.println(signature);
  }

  public static String getSignature(JSONObject param, String app_secret) {
      /*1.字典序排序,并拼接字符串*/
      StringBuilder builder = new StringBuilder();
      TreeSet set = new TreeSet<>(param.keySet());
      set.forEach(key -> {
          builder.append(key);
          if (key.equals("body")) {
              String body = JSON.toJSONString(param.getJSONObject(key), SerializerFeature.MapSortField);
              builder.append(body);
          } else {
              builder.append(param.getString(key));
          }
      });

      String requestString = builder.toString();
      System.out.println("requestString==>" + requestString);
      /*2.拼接原文串*/
      String soruceString = app_secret + requestString + app_secret;
      System.out.println("soruceString==>" + soruceString);
      /*3.对原文串进行MD5加密并转成大写*/
      return RSAUtlis.MD5Encrypt(soruceString).toUpperCase();
  }

                        

• 创建订单接口

• stationOrders请求参数:

• goodsMain请求参数:

{{ createOrder_requestCode }}

• 返回JSON格式，以下为参数说明：

• bodyMessage业务参数：

{{ createOrder_responseSuccessCode }}

• 查询订单的相关信息以及骑手的相关信息，具体信息参见参数说明。

{{ orderDetail_requestParam }}

• 返回JSON格式，以下为参数说明：

• bodyMessage业务参数：

{{ orderDetail_response }}

• 在订单待接单或待取货情况下，调用此接口可取消订单。

{{ orderCanelParam }}

• 返回JSON格式，以下为参数说明：

• bodyMessage业务参数：

• app_key: {{ app_key }}
• app_secret: {{ app_secret }}
• 商户ID: {{ businessId }}