C#_Express-ickd接口

爱查快递接口使用

using System;
using System.Collections.Generic;
using System.IO;
using System.Net;
using System.Text;
using System.Linq;
using Newtonsoft.Json;

namespace ClassLibrary
{
    //快递查询
    public static class Express
    {
        #region ickd.com快递查询接口Key和快递公司
        private const string ickdKEY = "";
        private const string ickdSecret = "";
        private static Dictionary<string, string> ickdComDic = new Dictionary<string, string>() {
                    {"顺丰快递","shunfeng"},
                    {"申通快递","shentong"},{"圆通快递","yuantong"},{"中通快递","zhongtong"},{"韵达快递","yunda"},
                    {"大田物流","datian"},{"德邦物流","debang"},{"D速快递","dsu"},{"EMS快递","ems"},{"华宇物流","huayu"},
                    {"汇通快递","huitong"},{"佳吉快运","jiaji"},{"京广快递","jingguang"},{"龙邦快递","longbang"},
                    {"天天快递","tiantian"},{"新邦物流","xinbang"},{"优速快递","yousu"},{"宅急送快递","zhaijisong"}
                };
        /// <summary>
        /// 获取快递公司集合
        /// </summary>
        public static List<string> idkdGetCom = ickdComDic.Keys.ToList<string>();
        #endregion

        #region 使用ickd.com接口获取快递信息
        /// <summary>
        /// 查询快递
        /// </summary>
        /// <param name="com">快递</param>
        /// <param name="nu">快递单号</param>
        /// <param name="order">排序顺序</param>
        /// <param name="type">返回值类型</param>
        /// <param name="encode">编码方式</param>
        /// <returns></returns>
        public static ickdModel GetICKDModel(string com, string nu, ickdOrderType order = ickdOrderType.desc, ickdDateType type = ickdDateType.json, ickdEncodeType encode = ickdEncodeType.gbk)
        {
            try
            {
                if (!ickdComDic.ContainsKey(com)) { return null; }//判断快递公司是否合法
                StringBuilder sb = new StringBuilder();
                sb.AppendFormat("http://api.ickd.cn/?id={0}&secret={1}&com={2}&nu={3}&type={4}&ord={5}&encode={6}", ickdKEY, ickdSecret, ickdComDic[com], nu, type, order, encode);

                HttpWebRequest request = (HttpWebRequest)WebRequest.Create(sb.ToString());//向url所在的服务器发送一个请求
                HttpWebResponse response = (HttpWebResponse)request.GetResponse(); //获得服务器的回应
                string charset = response.CharacterSet;
                Encoding reEncode = Encoding.GetEncoding(charset);
                TextReader text = new StreamReader(response.GetResponseStream(), reEncode);//初始化流
                string htmlContent = text.ReadToEnd();//获得网页内容
                response.Close();

                ickdModel model = JsonConvert.DeserializeObject<ickdModel>(htmlContent);
                return model.status != 0 ? model : null;
            }
            catch (Exception)
            {
                return null;
            }
        }
        #endregion
    }

    #region ickd枚举参数
    public enum ickdDateType
    {
        json, html, text, xml
    }
    public enum ickdOrderType
    {
        desc, asc
    }
    public enum ickdEncodeType
    {
        gbk, utf8
    }
    #endregion

    #region 快递信息
    public class ickdModel
    {
        /// <summary>
        /// 查询结果状态[0查询失败/1正常/2派送中/3已签收/4退回/5其他问题]
        /// </summary>
        public int status { get; set; }
        /// <summary>
        /// 错误消息
        /// </summary>
        public string message { get; set; }
        /// <summary>
        /// 进度
        /// </summary>
        public List<ickdInfoModel> data { get; set; }
        /// <summary>
        /// 快递单号
        /// </summary>
        public string mailNo { get; set; }
        /// <summary>
        /// 快递公司英文代码
        /// </summary>
        public string expSpellName { get; set; }
        /// <summary>
        /// 快递公司中文名
        /// </summary>
        public string expTextName { get; set; }
        /// <summary>
        /// 最后更新时间
        /// </summary>
        public string update { get; set; }
        /// <summary>
        /// 缓存时间
        /// </summary>
        public string cache { get; set; }
        /// <summary>
        /// 排序
        /// </summary>
        public string ord { get; set; }

    }
    #endregion

    #region 快递处理信息
    public class ickdInfoModel
    {
        /// <summary>
        /// 处理时间
        /// </summary>
        public string time { get; set; }
        /// <summary>
        /// 处理信息
        /// </summary>
        public string context { get; set; }
    }
    #endregion
}