这个工具借用了 JsonView 的一个控件, 从CodePlex 上下来的JsonView 用的是 Newtonsoft.Json 1.1.1.0 , 但是在 API 内,我用的是 4.5.0.0 的DLL去解析 API 返回的数据, 这样就造成了DLL版本不一致的问题. 

要解决这个问题,需要在 APP.config 里加一段:

 1 <configuration>
 2 
 3 <runtime>
 4 
 5 <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
 6 
 7 <dependentAssembly>
 8 
 9 <assemblyIdentity name="Newtonsoft.Json"/>
10 
11 <codeBase version="1.1.1.0" href="v1/Newtonsoft.Json_1.dll"/>
12 
13 <codeBase version="4.5.0.0" href="Newtonsoft.Json.dll"/>
14 
15 </dependentAssembly>
16 
17 </assemblyBinding>
18 
19 </runtime>
20 
21 </configuration>

将 1.1.1.0 的 DLL 放到程序目录下面的 V1 文件夹下, 版本冲突就解决了.

大至的一个结构:

Methods 下的每个类对应 API 里的每个方法, 大致如下:

 1 public class OrderQueryList : MethodBase<OrderList> {
 2 
 3 
 4 
 5 protected override string APIName {
 6 
 7 get { return "api.findOrderListQuery"; }
 8 
 9 }
10 
11 
12 
13 private int pageSize = 50;
14 
15 
16 
17 [ParamName("pageSize", Required = true)]
18 
19 public int PageSize {
20 
21 get {
22 
23  return pageSize;
24 
25 }
26 
27 set {
28 
29  this.pageSize = value < 1 ? 1 : (value > 50 ? 50 : value);
30 
31 }
32 
33 }
34 
35 
36 
37 private int page = 1;
38 
39 
40 
41 [ParamName("page", Required = true)]
42 
43 public int Page {
44 
45 get {
46 
47  return this.page;
48 
49 }
50 
51 set {
52 
53  this.page = value < 1 ? 1 : value;
54 
55 }
56 
57 }
58 
59 
60 
61 [ParamName("createDateStart")]
62 
63 [AliDateTimeParamFormatter("MM/dd/yyyy")]
64 
65 public DateTime? CreateBegin { get; set; }
66 
67 
68 
69 [ParamName("createDateEnd")]
70 
71 [AliDateTimeParamFormatter("MM/dd/yyyy")]
72 
73 public DateTime? CreateEnd { get; set; }
74 
75 
76 
77 [ParamName("orderStatus")]
78 
79 public OrderStatus? Status { get; set; }
80 
81 }
82 
83 

带 ParamName 特性的属性即API 说明列出的 API 方法所需要的参数, 在 MethodBase 里有个虚方法 Execute 及 GetResult.

 绝大部分API方法不需要重写这两个方法, 但是有两个特例(到目前为止,我遇到的): 和上传图片有关的两个方法.

http://gw.api.alibaba.com/dev/doc/api.htm?ns=aliexpress.open&n=api.uploadTempImage&v=1

大家可以看看, Ali 的人真是省事, 就几句话了事. 光凭这几句话, 打死我也想不出要怎么个上传法. 我费劲巴啦的耗了几个小时按照网页上传图片的方法对 RequestHelper 类进行修改,然后建个测试网站做测试, 改完后发现牙的根本就不是这样上传的, 结果死都是500,未找到文件.

后来在阿里巴巴的论坛里找到了某同志的回贴, 原来和从网页上传图片完全不搭调.

 1 [NeedAuth]
 2 public override string GetResult(Auth auth) {
 3 var url = auth.GetApiUrl(this.APIName).SetUrlKeyValue("srcFileName", this.FileName);
 4 using(var client = new WebClient()) {
 5  try {
 6  var result = client.UploadData(url, this.UploadData);
 7  return Encoding.UTF8.GetString(result);
 8  } catch(WebException ex) {
 9  return Encoding.UTF8.GetString(ex.Response.GetResponseStream().GetBytes());
10  }
11 }
12 }

原来是直接将文件的字节数组 Post 到特定格式的网址里, 真的是很晕,我熬夜到3点多,尽然是多此一举.

另外, 由于精力有限, 目前我只对照返回结果写了几个对应的实体, 其它的没有用到的,我不打算写, 如果各位有兴趣的话,可以反编译一下: AsNum.Aliexpress.API.dll 这个DLL, 源码我也不准备放出, 因为真的是很简单(只是有些繁琐而以), 有需要的可以自行反编译一下.

使用之前需要从菜单里设置一下 AppKey 和 SecretKey , 当然你需要有一个 Aliexpress 的账户.