首页 接口文档 接口申请 联调 常见问题 申通官网 关注我们
登录 | 注册

API类目汇总

申通产品时效接口基础需要授权

提供时效信息接口

  • 请求方式+

    本文档内描述的接口均采用HTTP传输协议。客户方采用POST或者GET方式发送至本接口。
  • 请求参数+

    参数名称 描述 必填
    systemCode 系统编号
    StartCity 出发地名称(格式为:省-市-区)
    EndCity 目的地名称(格式为:省-市-区)
    DataTime 寄件时间
    Weight 重量
    AppKey 接口账号(联系对接人申请、备案、开通)
    AppSecret 接口密钥(联系对接人申请、备案、开通)
  • 响应参数+

    参数名称 描述
    Status 接口请求状态,true或false
    StatusCode 接口请求状态码
    StatusMessage 接口请求返回状态消息
    RecordCount 接口返回记录总数
    ResultValue 返回值
    Data 快件跟踪业务数据
  • 请求示例+

      
                            接口地址:string url=""; 
                            var webClient = new WebClient(); 
                            var postValues = new NameValueCollection(); 
                            postValues.Add("appKey", " appKey"); 
                            postValues.Add("appSecret","appSecret" ); 
                            postValues.Add("systemCode", "SystemCode"); 
                            postValues.Add("data", "{\"StartCity\":\"北京-北京市-东城区\",\"EndCity\":\"天津-天津市-河东区\",\"Datetime\":\"2016-08-29%2008:25:33\",\"Weight\":10}"); 
                            byte[] responseArray = webClient.UploadValues(url, postValues); 
                            string response = Encoding.UTF8.GetString(responseArray);
    
  • 响应示例+

                            {
                            "Status": true, 
                            "ResultValue": "", 
                            "StatusCode": "OK", 
                            "StatusMessage": " 查询成功", 
                            "RecordCount": 0, 
                            "Data": 
                            {
                                "Time": "2016-08-31 03:25:33", 
                                "Price": 48.0, 
                             }
                            }                                 
                             
  • 异常示例+

                             {
                             "Status": false, 
                             "ResultValue": "", 
                             "StatusCode": "xxxx", 
                             "StatusMessage": "xxxx", 
                             "RecordCount": 0, 
                             "Data": null; 
                             }