SendCloud APIV2 beta 测试上线

技术

APIV2 较 APIV1 有很多变化:

1. 完善返回结果, 返回码, 提供用户更详尽的结果信息

APIV2 增加 200+ 个返回码, 让用户不再为调试代码而困扰.

API 返回的结果是 JSON 格式

  • result: API 请求是否成功
  • statusCode: API 返回码
  • message: API 返回码的中文解释
  • info: 数据信息

示例如下: 

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
**请求成功**
{
  "result": true,
  "statusCode": 200,
  "message": "请求成功",
  "info": {}
}
**认证失败**
{
  "result": false,
  "statusCode": 40005,
  "message": "认证失败",
  "info": {}
}
**数据获取成功**
{
  "statusCode": 200,
  "info": {
    "data": {
      "gmtCreated": "2015-10-19 15:39:27",
      "gmtUpdated": "2015-10-19 15:39:27",
      "labelId": ***,
      "labelName": "test"
    }
  },  
  "message": "请求成功",
  "result": true
}

2. 新增接口, 扩充参数, 完善返回信息

  • 新增接口: 日程发送, 模板提交
  • 扩充参数:
    发送 API 增加参数回执地址, 纯文本发送 等参数.
    模板 API 增加参数是否提审.
  • 完善返回信息:
    balabala

3. 其他变化

模块: 功能模块名称. 比如: mail (邮件模块), addresslist (地址列表) 等.

动作: 每个模块所实现的功能. 比如: send, add 等.

  • 只提供 JSON 格式的返回结果

  • 参数使用驼峰命名格式