网站开发技术

API文档/物流跟踪/物流查询

应用场景

1.在电商平台购物后，通过购物订单跟踪物流时，调用此API获取物流信息详情

2.处理运费对账时，一键获取运单物流状态

3.批量跟踪及获取运单物流信息

支持品牌列表下载并查看详情

技术咨询请加微信：kuaibao135

接口名称

express.info.get

公共参数

请求地址

公共请求参数

公共响应参数

请求参数

响应参数

请求示例

Java

C#

Python

PHP

Node.js

Curl

import java.security.MessageDigest;import java.security.NoSuchAlgorithmException;import java.util.Map;import java.util.HashMap;import java.util.Date;public class Request {public static void main(String[] args) {String host = "http://kop.kuaidihelp.com";String path = "/api";String requestMethod = "POST";
Map<String, String> headers = new HashMap<String, String>();//根据API的要求，定义相对应的Content-Typeheaders.put("Content-Type", "application/x-www-form-urlencoded; charset=UTF-8");
Map<String, String> querys = new HashMap<String, String>();
Map<String, String> bodys = new HashMap<String, String>();String appId = "50001";String method = "express.info.get";// 当前时间戳String ts = new Date().getTime() + "";String appKey = "bdf3b5f50865ac813cbdfd6c9b572b79";// 计算签名String signStr = appId + method + ts + appKey;String sign = Request.getMD5(signStr, 32);
bodys.put("app_id", appId);
bodys.put("method", method);
bodys.put("ts", ts);
bodys.put("sign", sign);// data参数是个json格式的字符串  建议使用函数或方法去生成bodys.put("data", "{ "waybill_codes":"物流单号多个的以英文逗号分隔", "cp_code":"品牌简称","result_sort":"0"}");try {    /**
    * 重要提示如下:
    * HttpUtils请从
    * https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/src/main/java/com/aliyun/api/gateway/demo/util/HttpUtils.java
    * 下载
    *
    * 相应的依赖请参照
    * https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/pom.xml
    */
    HttpResponse response = HttpUtils.doPost(host, path, requestMethod, headers, querys, bodys);
    System.out.println(response.toString());    
        //获取response的body
        System.out.println(EntityUtils.toString(response.getEntity()));
    } catch (Exception e) {
        e.printStackTrace();
    }
}    // 计算md5
    public static String getMD5(String plainText, int length) {        try {
            MessageDigest md = MessageDigest.getInstance("MD5");//获取MD5实例
            md.update(plainText.getBytes());//此处传入要加密的byte类型值
            byte[] digest = md.digest();//此处得到的是md5加密后的byte类型值
            /*
               下边的运算就是自己添加的一些二次小加密，记住这个千万不能弄错乱，
                   否则在解密的时候，你会发现值不对的（举例：在注册的时候加密方式是一种，
                在我们登录的时候是不是还需要加密它的密码然后和数据库的进行比对，但是
            最后我们发现，明明密码对啊，就是打不到预期效果，这时候你就要想一下，你是否
             有改动前后的加密方式）   
            */
            int i;
            StringBuilder sb = new StringBuilder();            for (int offset = 0; offset < digest.length; offset++) {
                i = digest[offset];                if (i < 0)
                    i += 256;                if (i < 16)
                    sb.append(0);
                sb.append(Integer.toHexString(i));//通过Integer.toHexString方法把值变为16进制
            }            return sb.toString().substring(0, length);//从下标0开始，length目的是截取多少长度的值
        } catch (NoSuchAlgorithmException e) {
            e.printStackTrace();            return null;
        }
    }
}

响应示例

成功响应示例

JSON示例

{

"code":

int0

"msg":

string"查询成功"

"data":[

0:{

"waybill_code":

string"3339809700595"

"cp_code":

string"sto"

"status":

string"signed"

"data":[

0:{

"time":

string"2017-10-03 19:11:00"

"context":

string"已签收,签收人是代签"

}

1:{

"time":

string"2017-10-03 08:14:33"

"context":

string"快件已到达 浙江浦江公司"

}

2:{

"time":

string"2017-10-03 01:09:41"

"context":

string"由浙江义乌中转部 发往 浙江浦江公司"

}

]

"order":

string"desc"

}

]

}

异常响应示例

JSON示例

{

"code":

string"错误代码"

"msg":

string"错误信息"

"data":{}

}

错误代码

API文档/地址库服务/智能解析

应用场景

1. 电商平台、电商ERP软件、物流应用软件等需要录入联系人信息，允许用户自由输入联系信息，无需分段按规格录入，提升录入效率和使用体验

2. 已有的联系人信息为纯文本，需要自动解析为姓名、电话、省市区、详细地址和备注

3. 用户输入的联系人信息中，省、市、区信息不全或有错误，需要自动纠正为完整、准确的行政区域信息

主要功能

1. 将包含收发件人信息的文本，识别为结构化的收发件人信息，返回姓名、电话号码、省、市、区、乡镇、详细地址、备注等分段信息，能够智能补全地址中缺失的行政区域

2. 对于包含了不规范的行政区域名称、过时的旧称呼、已经撤销或合并的行政区域名称的地址，可以通过该接口解析为规范、最新、准确的行政区域名称

额外说明

技术咨询请加微信：kuaibao135

接口名称

cloud.address.resolve

公共参数

请求地址

公共请求参数

公共响应参数

请求参数

响应参数

请求示例

单条请条示例

Java

C#

Python

PHP

Node.js

Curl

import java.security.MessageDigest;import java.security.NoSuchAlgorithmException;import java.util.Map;import java.util.HashMap;import java.util.Date;public class Request {public static void main(String[] args) {String host = "http://kop.kuaidihelp.com";String path = "/api";String requestMethod = "POST";
Map<String, String> headers = new HashMap<String, String>();//根据API的要求，定义相对应的Content-Typeheaders.put("Content-Type", "application/x-www-form-urlencoded; charset=UTF-8");
Map<String, String> querys = new HashMap<String, String>();
Map<String, String> bodys = new HashMap<String, String>();String appId = "50001";String method = "cloud.address.resolve";// 当前时间戳String ts = new Date().getTime() + "";String appKey = "bdf3b5f50865ac813cbdfd6c9b572b79";// 计算签名String signStr = appId + method + ts + appKey;String sign = Request.getMD5(signStr, 32);
bodys.put("app_id", appId);
bodys.put("method", method);
bodys.put("ts", ts);
bodys.put("sign", sign);// data参数是个json格式的字符串  建议使用函数或方法去生成bodys.put("data", "{
    "text":"浙江省绍兴市诸暨市浣东街道西子公寓北区电话：13905857430  衣服  食物 ",
    "multimode":false
}");try {    /**
    * 重要提示如下:
    * HttpUtils请从
    * https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/src/main/java/com/aliyun/api/gateway/demo/util/HttpUtils.java
    * 下载
    *
    * 相应的依赖请参照
    * https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/pom.xml
    */
    HttpResponse response = HttpUtils.doPost(host, path, requestMethod, headers, querys, bodys);
    System.out.println(response.toString());    
        //获取response的body
        System.out.println(EntityUtils.toString(response.getEntity()));
    } catch (Exception e) {
        e.printStackTrace();
    }
}    // 计算md5
    public static String getMD5(String plainText, int length) {        try {
            MessageDigest md = MessageDigest.getInstance("MD5");//获取MD5实例
            md.update(plainText.getBytes());//此处传入要加密的byte类型值
            byte[] digest = md.digest();//此处得到的是md5加密后的byte类型值
            /*
               下边的运算就是自己添加的一些二次小加密，记住这个千万不能弄错乱，
                   否则在解密的时候，你会发现值不对的（举例：在注册的时候加密方式是一种，
                在我们登录的时候是不是还需要加密它的密码然后和数据库的进行比对，但是
            最后我们发现，明明密码对啊，就是打不到预期效果，这时候你就要想一下，你是否
             有改动前后的加密方式）   
            */
            int i;
            StringBuilder sb = new StringBuilder();            for (int offset = 0; offset < digest.length; offset++) {
                i = digest[offset];                if (i < 0)
                    i += 256;                if (i < 16)
                    sb.append(0);
                sb.append(Integer.toHexString(i));//通过Integer.toHexString方法把值变为16进制
            }            return sb.toString().substring(0, length);//从下标0开始，length目的是截取多少长度的值
        } catch (NoSuchAlgorithmException e) {
            e.printStackTrace();            return null;
        }
    }
}

响应示例

成功响应示例

JSON示例

{

"code":

int0

"msg":

string"成功"

"data":[

0:{

"original":

string"浙江省绍兴市诸暨市浣东街道西子公寓北区电话：13905857430 衣服 食物 "

"phone":

string""

"mobile":

string"13905857430"

"name":

string"衣服 食物"

"note":

string""

"province_id":

string"334"

"province_name":

string"浙江省"

"province_shortname":

string"浙江"

"province_code":

string"330000"

"city_id":

string"1304"

"city_name":

string"绍兴市"

"city_shortname":

string"绍兴"

"city_code":

string"330600"

"county_id":

string"1357"

"county_name":

string"诸暨市"

"county_shortname":

string"诸暨"

"county_code":

string"330681"

"detail":

string"西子公寓北区"

"town_id":

string"883331"

"town_name":

string"浣东街道"

"town_code":

string""

}

]

}

异常响应示例

JSON示例

{

"code":

int400001

"msg":

string"业务参数有误，请检查"

"uid":

string"a6934adee62d8ba3430d4ac678dd5f46c7a79d6e"

"data":{}

}

错误代码