通过本文您可以了解使用SDK时需要遵循的原则。

Request-Response原则

使用不同语言的SDK调用API时,SDK接口均需要遵循Request-Response原则。调用API的具体方式如下:
  1. 利用请求参数构造相应的Request实例。
  2. 调用SDK中的相应接口并传入已构造的Request实例。
  3. SDK接口的返回结果以相应的Response实例返回给用户。

示例

如下示例展示了使用Java SDK调用API时的标准用法、可选用法以及客户端Web系统中的推荐用法。
  • 标准用法
    ListProjectsRequest req = new ListProjectsRequest();
    ListProjectsResponse res = client.getResponse(req);           
  • 可选用法
    ListProjectsRequest req = new ListProjectsRequest();
    String resultJson = client.getResponseString(req);           
  • 客户端Web系统中标准用法
    Map<String, String> map = new HashMap<String,String>();
    map.put("Action","ListProjects");
    String resultJson = client.getResponseString(map);           

    关于Action的使用请参见API概览