1. Inicio
  2. Integracoes
  3. API

简介

我们的API接口用于将SendPulse的分发服务功能与客户的个人项目集成。开云体育手机网页版登录入口官网该API是为开发人员设计的，并附有详细的文档。

描述

开云体育手机网页版登录入口官网SendPulse的REST API在HTTPS协议上工作，本质上是一组用于执行每个操作的请求和接收响应的方法。所有答案都以JSON结构的形式返回。

请求限制为每秒10个请求。

不允许跨域查询(jQuery Ajax示例)。

开云体育手机网页版登录入口官网SendPulse API库

SendPulse API客户端库的最新版本可开云体育手机网页版登录入口官网在以下站点获得GitHub．

你也可以查看其他Github上的第三方解决方案．

基URL

本文档中所有对API请求的引用都包括根URL:

https://api.开云体育手机网页版登录入口官网www.alanlshields.com

授权

授权过程需要一个个人密钥来签署每个进一步的API请求。

获取密钥的必要参数可以在私有帐户设置页面中找到API选项卡．

为了获得密钥，你必须发送一个POST请求到:

https://api.开云体育手机网页版登录入口官网www.alanlshields.com/oauth/access_token

请求参数:

参数 类型 描述
grant_type 字符串 必须等于client_credentials 要求
client_id 字符串 你的身份证 要求
client_secret 字符串 你的秘密 要求

请求示例:

{"grant_type":"client_credentials"， "client_id":"237b4af9c99d0f89bdbd876dcd5a0000"， "client_secret":"a99e7d506d3701c5c04de3db1913eeee"}

如果请求成功，您将收到回复:

{“access_token”:“eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6IjI5NTQ4NDVjZWJlZjg5Nzk0YmYzMzk4ZDdiNTQ3OTA2MWUzNDQ2N2I5NTUwMmFlNzE1YmViZmU4MDBmNTMxMjIxMTU2MTcyOWM2MjI5NGRjIn0.eyJhdWQiOiIyMzdiNGFmOWM5OWQwZjg5YmRiZDg3NmRjZDVhMDE3ZiIsImp0aSI6IjI5NTQ4NDVjZWJlZjg5Nzk0YmYzMzk4ZDdiNTQ3OTA2MWUzNDQ2N2I5NTUwMmFlNzE1YmViZmU4MDBmNTMxMjIxMTU2MTcyOWM2MjI5NGRjIiwiaWF0IjaaNjI0NTI0OTA0LCJuYmYiOjE2MjQ1MjQ5MDQsImV4cCI6MTYyNDUyODUwNCwic3ViIjoiIiwic2NvcGVzIjpbXSwidXNlciI6eyJpZCI6Njc0MTgwNCwiZ3JvdXBfaWQiOm51bGwsInBhcmVudF9pZCI6bnVsbCwiYXJlYSI6InJlc3QifX0。jip3sv7if1mhgmw0ogirpaw0ooiienc8tb6wlwu5evm2urhl6rzsdlisllsqnevl_e50ndlgtgyfx5qty4qlq4xyjwhbyqgvvkw8zqy7wyxhicpaf8zdf8 - gbhbnzqy0oxo4_bfrhcpmkbgj2m7y0oxo4_bfrhvbiawd09m0a9uwosnozkxxw0o64pe3anjta6lfns5sduyegxanotuzss5i3umi2oonuvzng9_5wjce6lpvqlapapt0m8s5wki35_jcj0a - gdbbdsgnuudgcvsdcgeog "， "token_type": "小熊"，"expires_in": 3600}

一个示例键:

授权:持票人eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6IjI5NTQ4NDVjZWJlZjg5Nzk0YmYzMzk4ZDdiNTQ3OTA2MWUzNDQ2N2I5NTUwMmFlNzE1YmViZmU4MDBmNTMxMjIxMTU2MTcyOWM2MjI5NGRjIn0.eyJhdWQiOiIyMzdiNGFmOWM5OWQwZjg5YmRiZDg3NmRjZDVhMDE3ZiIsImp0aSI6IjI5NTQ4NDVjZWJlZjg5Nzk0YmYzMzk4ZDdiNTQ3OTA2MWUzNDQ2N2I5NTUwMmFlNzE1YmViZmU4MDBmNTMxMjIxMTU2MTcyOWM2MjI5NGRjIiwiaWF0IjaaNjI0NTI0OTA0LCJuYmYiOjE2MjQ1MjQ5MDQsImV4cCI6MTYyNDUyODUwNCwic3ViIjoiIiwic2NvcGVzIjpbXSwidXNlciI6eyJpZCI6Njc0MTgwNCwiZ3JvdXBfaWQiOm51bGwsInBhcmVudF9pZCI6bnVsbCwiYXJlYSI6InJlc3QifX0.jiP3Sv7IF1mHGmW0oGIrPAw0oOiIEnC8Tb6wlWu5eVM2UrHL6RZsDlIslLSQNEvL_e50nDlgtgyfX5Qty4qlQ4XyW53FAgjwHbyQG7DJ6iVRAtVBtFNbkFVNbHvKw8zQy7WyxhICpAF8zdF8-gBHBnzuMhKSnASYEosJ9IAPqUkxQXrd8LpUSk-etzjEqcpMkbGj2M7Y0OxO4_BfRhVNU6ZcbiawD09m0A9uWoSnoZKxXw0o64PE3anJta6lFns5SDuyeGxanOtuZSS5I3umI2OOnUVzNG9_5WjCe6LPVQLAPAPt0m8S5WkI35_jCJ0A-gDBBdsgnUudGCvsDcgEog

生成的密钥在1小时内有效，并且不需要为每个操作请求额外的请求。必须在当前密钥过期之前发送对新密钥的请求。

密钥代码(令牌)必须在所有请求的头中发送，但获取令牌本身的请求除外(当不需要密钥时)。

请求限制

有限制和配额开云体育手机网页版登录入口官网SendPulse API请求防止系统接收超过其处理能力的数据，确保系统资源的公平分配。每分钟和每天的API限制取决于所选定价计划的类别

一般配额限额

以下配额适用于发送API请求:

定价方案 每分钟请求数 每天请求数 服务定价方案
免费的 1000年 500000年 SMTP、登录页、推送和聊天机器人服务中的所有免费定价计划
标准 2000年 100万年 “免费”和“企业”之间的所有定价方案
企业 3000年 3数百万 “企业”类别的电子邮件和登录页服务，以及“专业”类别的推送服务，订阅人数超过50,000人;

订阅人数超过5000人的“专业”类别聊天机器人服务;
超过10万封邮件的SMTP服务。

超过配额限制

如果你超过了这个配额，API返回以下错误:

请求太多

为了能够发送更多请求，您需要升级当前的定价计划。

错误码和描述

错误代码 描述
8 没有数据
10 寄件人电邮地址遗失
11 找不到收件人地址
13 空的电子邮件内容字段
14 找不到指定ID的电子邮件地址
17 找不到邮箱地址
19 电子邮件地址已存在
20. 使用免费电子邮件服务(不允许)
21 没有这样的电子邮件地址等待激活
97 无效的邮件地址类型。不允许使用免费电子邮件服务。
201 空邮件列表名称
203 此邮件列表名称已存在
211 邮件列表为空
213 未找到邮件列表
303 在邮件列表中找不到电子邮件地址
400 指定的SMTP用户不存在。创建SMTP帐户。
502 找不到邮箱地址
602 找不到活动。可能已经发送出去了。
701 未指定发件人电子邮件地址或姓名。
703 找不到邮件列表
704 找不到发件人
707 账户余额耗尽
711 等待15分钟后再次发送到相同的列表
720 空主题字段
721 邮件信息为空
722 邮件列表ID未指定
791 api活动超过限制(每小时5个)
799 日期格式不正确。使用等于或大于当前日期的YYYY-MM-DD hh:ii:ss
800 无效的操作
802 未找到活动
901 未指定发件人名称
902 所选电子邮件地址已在使用中
903 发件人电子邮件地址未指定
904 邮件地址被列入黑名单
905 发件人地址配额已达
906 邮件地址语法错误
1101 未填写电邮地址
1003 指定的发件人不存在
1004 激活码已发送。请等待15分钟后重试
1005 发送确认错误
1104 未指定激活码
2020202020 每秒超过10个请求
Baidu
map