# 获取token --- 通过用户名密码获取token ### URL http://www.sendpost.cn/api/user/gettoken ### HTT请求方式 GET ### 参数说明 参数 | 类型 | 必须 | 说明 ---|---|---|--- api_user | string | 是 | 等同于用户名 api_key | string | 是 | 系统分配 ### 请求示例 http://www.sendpost.cn/api/user/gettoken?api_user=xxx&api_key=xxx ### 返回值说明 参数 | 说明 ---|--- status | 状态 msg | 返回信息 token | 取回token ### 返回示例 ``` { "status": 0, "msg" : '', "token": "c31e41940cd12cf9b24b0e528ab955bc" } ``` # 邮件发送 --- ### URL http://www.sendpost.cn/api/mail/sendtemplate ### HTT请求方式 POST ### 参数 参数 | 类型 | 必须 | 说明 ---|---|---|--- token | string | 是 | TOEKN from | string | 是 | 发件人地址 fromname | string | 否| 发件人名称。如 站长:sengpost,公司:重庆熠巨数字 replyto | string | 否 | 回复地址。不填写默认发件人地址 to | string | 是 | 收件人地址 template_alias| string | 是 | 模版别名 substitution_vars | string | 是 | 模板替换变量。{"%name%": "张三", "%phone%": '13800000000'} ### 返回示例 ``` { "status": 0, "msg" : '' } ``` # 邮件模版 --- ## 查询 --- 返回所有模版列表,缓存时间为2个小时 ### URL http://www.sendpost.cn/api/template/list ### HTT请求方式 GET ### 参数说明 参数 | 类型 | 必须 | 说明 ---|---|---|--- token | string | 是 | TOEKN page | int | 否 | 默认1 ### 请求示例 http://www.sendpost.cn/api/template/list?token=xxx&page=xxx ### 返回值说明 参数 | 说明 ---|--- status | 状态 msg | 返回信息 data | 列表数据 > date 详细属性说明 属性 | | 说明 --- | --- | --- pagin | |页码项 |page | 当前页 |limit | 当前页面大小 |totalSize | 共多少条数 |totalPage | 共多少页 items | | 数据项 | id | 数据ID | name | 模版名称 | alias | 模版别名,发送邮件使用。 | title | 邮件模版标题。 以前后百分号未变量,如:%name% | content | 邮件模版内容。同上 | inputtime | 添加时间 | lasttime | 最后修改时间 | audit | 是否审核通过。 1审核通过 0待审核 -1审核未通过 ### 返回示例 ``` { "status":0, "data":{ "pagin":{"page":1,"limit":20,"totalSize":"1","totalPage":1}, "items":[{"id":"1","name":"\u6d4b\u8bd5","alias":"test","title":"\u53ea\u662f\u6d4b\u8bd5\uff0c%name%","content":"&lt;p&gt;\r\n\t%name%\u60a8\u597d\uff0c\u8ba2\u5355\u53f7\u662f%orderno%\r\n&lt;\/p&gt;\r\n&lt;p&gt;\r\n\t&lt;img src=&quot;http:\/\/www.sd.com\/upfile\/images\/2016\/07\/20\/20160720173455578f45bfda3fcbhersm.jpg&quot; alt=&quot;&quot; \/&gt; \r\n&lt;\/p&gt;\r\n&lt;p&gt;\r\n\t\u53ea\u662f\u6d4b\u8bd5\r\n&lt;\/p&gt;","inputtime":"1469007311","lasttime":"1469087344","audit":"1"}] } } ``` ## 添加 --- ### URL http://www.sendpost.cn/api/template/add ### HTT请求方式 POST ### 参数说明 参数 | 类型 | 必须 | 说明 ---|---|---|--- token | string | 是 | TOKEN name | string | 是 | 模版名称 alias | string | 是 | 模版别名,唯一 title | string | 是 | 发送邮件模版标题。以前后百分号未变量,如:%name% content | string | 是 | 发送邮件模版内容。同上 ### 返回值说明 参数 | 说明 ---|--- status | 状态 msg | 返回信息 ### 返回示例 ``` { "status":0, "msg":"模版添加成功" } ``` ## 更新 --- ### URL http://www.sendpost.cn/api/template/update ### HTT请求方式 POST ### 参数说明 参数 | 类型 | 必须 | 说明 ---|---|---|--- token | string | 是 | TOKEN id | int | 是 | 模版ID name | string | 否 | 模版名称 alias | string | 否 | 模版别名,唯一 title | string | 否 | 发送邮件模版标题。以前后百分号未变量,如:%name% content | string | 否 | 发送邮件模版内容。同上 ### 返回值说明 参数 | 说明 ---|--- status | 状态 msg | 返回信息 updateCount | 更新的条数 ### 返回示例 ``` { "status":0, "msg":"模版更改成功", "updateCount": 1 } ``` ## 删除 --- ### URL http://www.sendpost.cn/api/template/delete ### HTT请求方式 POST ### 参数说明 参数 | 类型 | 必须 | 说明 ---|---|---|--- token | string | 是 | TOKEN id | int | 是 | 模版ID ### 返回值说明 参数 | 说明 ---|--- status | 状态 msg | 返回信息 deleteCount | 删除的条数 ### 返回示例 ``` { "status":0, "msg":"模版删除成功", "deleteCount": 1 } ``` # 规则(返回码) --- API 返回的结果是 JSON 格式, 示例如下: ``` # 请求成功 { "status": 0, "data": {} } # 认证 { "status": 0, "msg" : '', "token": "c31e41940cd12cf9b24b0e528ab955bc" } ``` 参数 | 说明 ---|--- status | 返回状态码 msg | 返回信息,错误信息等 data | 返回数据 token | 认证信息 API 返回码如下: API 返回码 | 含义 ---|--- 0 | 成功 40001 | API_USER必传 40002 | API_KEY必传 40003 | 获取token失败 40004 | token验证失败 40005 | 传入模版ID有错误 40006 | 模版暂未审核通过,请联系平台客服 40007 | 参数错误。 40008 | 模版别名已经存在,请更改其他名称。 40009 | token已经过期,请重新获取 40010 | 服务器繁忙 40011 | 模版添加失败 40012 | 模版更改失败 40013 | 模版删除失败 40014 | 余额不足 40015 | API_USER和API_KEY错误 50000 | 服务器出错。返回信息是服务端返回的异常,遇见此信息请联系客服。 ## 代码示例 --- <a href="http://pan.baidu.com/s/1o8TedAU" target="_blank">获取代码示例</a> 提取码: auzc
Copyright © 2016 重庆熠巨数字传媒有限公司 渝ICP备15003730号-9