规则

API 的请求格式

https://api.sendcloud.net/apiv2/<模块>/<动作>

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

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


API 返回码

API 返回的结果是 JSON 格式, 示例如下:

# 请求成功
{
  "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
}

API 返回码如下:

API 返回码 含义
200 请求成功
40000 重复请求
40001 start不能为空
40002 start非法
40003 limit不能为空
40004 limit非法
40005 认证失败
40006 days格式非法,必须是大于0的正整数
40007 startDate格式错误,应该类似'2013-03-19'
40008 endDate格式错误,应该类似'2013-03-19'
40009 labelIdList不能为空
40010 apiUserList不能为空
40011 email不能为空
40012 email格式非法
40013 domainList不能为空
40014 标签ID不能为空
40015 标签ID格式错误
40016 apiUserList格式非法
40017 聚合参数格式错误
40100 标签创建成功
40101 标签创建失败
40102 标签ID不能为空
40103 标签ID非法
40104 标签名称不能为空
40105 标签名称的长度应该为1-255个字符
40106 标签ID对应的标签不存在
40107 标签删除成功
40108 标签删除失败
40109 标签更新成功
40110 标签更新失败
40111 query不能为空
40112 query的长度的长度应该为1-255个字符
40113 标签名称已经存在
40201 模版调用名称invokeName不能为空
40202 模版调用名称invokeName格式错误
40203 模版类型不能为空
40204 非法的模板类型, 只能是0或者1
40205 templateStat不能为空
40206 templateStat非法, 只能是-1, -2, 1, 0中的值
40207 name不能为空
40208 name格式非法
40209 subject不能为空
40210 subject格式非法
40211 html不能为空
40212 html格式非法
40213 text不能为空
40214 text格式非法
40215 模板创建失败
40216 模板调用名称对应的模板不存在
40217 模板删除失败
40218 模板更新失败
40219 用户最多只能有50个模板
40220 模版调用名称已经存在
40221 isSubmitAudit不能为空
40222 isSubmitAudit格式错误
40223 模板处于待审核状态, 不能修改
40224 cancel不能为空
40225 cancel格式错误
40226 模板处于待审核状态, 无需再次提交
40227 模板已经审核通过, 无需再次提交
40228 模板处于审核失败状态, 无需撤销审核
40229 模板还未提交审核, 无法撤销审核
40229 模板还未提交审核, 无法撤销审核
40230 模板调用名称 与 (开始日期 、结束日期) 参数两者不能同时为空
40231 taskId必须是数值
40232 taskName不能为空
40233 taskName长度超过256个字符
40234 runTime不能为空
40235 runTime格式不正确,需为yyyy-MM-dd HH:mm:ss
40236 runTime必须晚于当前时间
40237 未指定上传文件名
40238 文件名不能超过255个字符
40239 文件名后缀不能为空
40240 不能上传%s格式文件(如js,com,exe,sh,cs)
40241 存储空间不够,请删除部分文件后再上传
40242 定时任务创建成功
40243 定时任务创建失败
40244 定时任务删除成功
40245 定时任务删除失败
40246 定时任务更新成功
40247 定时任务更新失败
40248 文件上传失败!
40249 有邮件附件需要上传,runTime需在当前时间上延后5分钟!
40250 重复创建定时任务
40251 频繁更新定时任务
40252 taskId对应的定时任务不存在
40253 仅还未开始执行的定时任务可以删除
40254 仅还未开始执行的定时任务可以更新
40255 地址列表中成员地址的个数不能为0
40256 邮件附件上传超时
40257 发信人地址from最大128个字符
40258 参数emptyExistedAttachments不能为空,且值只能为0或1
40401 取消订阅记录创建成功
40402 取消订阅记录创建失败
40403 取消订阅记录删除成功
40404 取消订阅记录删除失败
40501 name不能为空
40502 地址列表名称的长度应该为1-48个字符
40503 address不能为空
40504 地址列表别名的长度应该为1-48个字符
40505 地址列表别名已经存在
40506 desc不能为空
40507 地址列表描述的长度应该为1-250个字符
40508 地址列表创建失败
40509 newAddress不能为空
40510 新的地址列表别名的长度应该为1-48个字符
40511 address参数错误
40512 members不能为空
40513 成员地址的长度应该为1-48个字符
40514 成员地址的个数不能小于0
40515 成员地址的个数不能超过1000
40516 添加成员失败
40517 地址列表不属于此用户
40518 成员地址不符合邮件地址规范
40519 删除成员失败
40520 vars不能为空
40521 vars参数中变量个数和成员地址个数不相等
40522 vars参数不符合JSON字符串语法
40531 单成员变量最大长度为1024个字符
40601 退信记录删除成功
40602 退信记录删除失败
40603 邮箱地址已经存在
40604 过期时间格式为: 2018-03-19
40701 分组ID不能为空
40702 分组ID格式错误
40703 事件类型不能为空
40704 事件类型格式错误,没有可用的事件类型
40705 url不能为空
40706 url格式错误
40707 url测试失败
40708 url已存在
40709 groupId对应的webhook配置未找到
40710 webhook配置创建失败
40711 webhook配置删除失败
40712 webhook配置修改失败
40801 发信人地址from不能为空
40802 发信人地址from格式错误
40803 发信人名称fromName不能为空
40804 发信人名称fromName格式错误
40805 收件人地址不能为空
40806 收件人地址数组中, 存在非法地址
40807 收件人地址的数目不能超过100
40808 邮件主题subject不能为空
40809 邮件主题subject格式错误
40810 回复地址replyto不能为空
40811 回复地址replyto格式错误
40812 xsmtpapi不能为空
40813 xsmtpapi格式错误
40814 xsmtpapi解析值不能为空
40815 xsmtpapi必须含有to字段
40816 xsmtpapi中to字段的解析值不能为空
40817 xsmtpapi解析错误
40818 attachments不能为空
40819 附件大小不能超过10485760字节
40820 此用户没有使用地址列表的权限
40821 地址列表任务创建成功
40822 地址列表任务创建失败
40823 邮件模板不存在
40824 模板未通过审核
40825 邮件模板和API_USER类型不匹配
40826 参数subject和模板主题不能同时为空
40827 xsmtpapi中to数组长度不能超过100
40828 回执地址不能为空
40829 回执地址格式错误
40830 plain内容不能为空
40831 plain内容格式错误
40832 会议起始时间startTime不能为空
40833 会议起始时间startTime格式错误
40834 会议结束时间endTime不能为空
40835 会议结束时间endTime格式错误
40836 会议标题title不能为空
40837 会议标题title格式错误
40838 会议组织者名称不能为空
40839 会议组织者名称格式错误
40840 会议组织者邮件地址不能为空
40841 会议组织者邮件地址格式错误
40842 会议地点location不能为空
40843 会议地点location格式错误
40844 会议描述description不能为空
40845 会议描述description格式错误
40846 会议参与者名称不能为空
40847 会议参与者名称格式不对
40848 会议参与者邮件地址不能为空
40849 会议参与者邮件地址格式错误
40850 会议参与者名称个数和会议参与者邮件地址个数不相等
40851 会议邮件拼装失败
40852 cc地址不能为空
40853 cc地址格式错误
40854 CC地址的数目不能超过100
40855 bcc地址不能为空
40856 bcc地址格式错误
40857 BCC地址的数目不能超过100
40858 respEmailId不能为空
40859 respEmailId格式错误
40860 gzipCompress不能为空
40861 gzipCompress格式错误
40862 to中有格式错误的地址列表
40863 to中有不存在的地址列表
40864 地址列表的数目不能超过5
40865 html解压失败
40866 plain解压失败
40867 处理附件发生异常
40868 headers不能为空
40869 headers格式错误
40870 html和plain不能同时为空
40871 html格式错误
40872 邮件列表地址不能为空
40873 useAddressList不能为空
40874 useAddressList格式错误
40875 内嵌图片ID或内嵌图片附件长度不一致
40876 是否取消日程参数isCancel格式错误
40877 摘要不能为空
40878 摘要长度不能超过255个字节
40879 回复地址replyto个数不能超过3个
40880 xsmtpapi中to字段含有非法邮箱格式
40901 邮件发送失败.
40902 邮件处理发生未知异常
40903 邮件发送成功
40904 额度检查失败
40905 额度检查通过
40906 额度检查临时通过
40907 该API_USER对应的内容不需要进行模板匹配
40908 邮件内容和邮件模板匹配不通过
40909 邮件内容和邮件模板匹配通过
40910 邮件内容和邮件模板匹配临时通过
40911 邮件内容和邮件模板匹配时出现编码错误
41001 name不能为空串
41002 name的长度应该为1-250个字符
41003 name不符合域名规则
41004 newName不能为空串
41005 newName的长度应该为1-250个字符
41006 newName不符合域名规则
41007 type不能为空串
41008 type不符合规则
41009 verify不能为空串
41010 verify不符合规则
41011 verify解析错误
41012 用户创建域名不能超过5个
41013 name参数错误, 多个域名
41014 域名不存在
41015 domain创建失败
41016 domain修改失败
41101 emailType不能为空串
41102 emailType不符合规则
41103 cType不能为空串
41104 cType不符合规则
41105 domainName不能为空串
41106 domainName不符合规则
41107 domainName的长度应该为1-250个字符
41108 domainName所属的域名不存在
41109 用户信息不存在
41110 name不能为空串
41111 name不符合规则, name的长度为6-32的字符串, 只能含有(A-Z,a-z,0-9,_)
41112 apiUser不能超过10个
41113 open不能为空串
41114 open不符合规则
41115 click不能为空串
41116 click不符合规则
41117 unsubscribe不能为空串
41118 unsubscribe不符合规则
41119 apiUser创建失败
49901 url格式错误
49902 http请求执行异常
49903 http请求执行失败
49904 http请求执行成功
49905 http返回结果解析错误
49906 http其他错误
50000 接口频率受限(每个apiuser,每个接口、每分钟调用4000次,目前只限制投递回应)
50001 邮件发送失败.536 Frequency limited(每个apiuser每分钟调用总请求数不能超过4万次)
51001 sender不能为空
51002 sender长度不能超过250字符
51003 sender前缀不能包含@符号
51004 domain长度不能超过250字符
51005 指定删除数据不存在
51006 删除成功
51007 categoryName不能为空
51009 邮件日志查询未开通
501 服务器异常
6001 你没有权限访问