取消订阅
在你的名单中有不感兴趣的订阅者?没关系,您所需要做的就是输入API身份验证令牌来取消订阅,然后将通知用户。
请求 URL
XML: https://campaigns.zoho.com.cn/api/xml/listunsubscribe
JSON: https://campaigns.zoho.com.cn/api/json/listunsubscribe
请求类型: Post
参数列表
参数 | 数据类型 | 描述 |
authtoken* | 字符串 | API 身份验证令牌 |
listkey* | 字符串 | 用于从列表中取消订阅者的列表键。 |
version | 字符串 | 这将基于当前API版本获取响应 |
resfmt | 字符串 | XML (或) JSON |
contactinfo* | XML (或) JSON | 联系人邮件与其它字段,该值的格式取决于请求URL。 |
* - 必填参数
示例请求:
XML:
https://campaigns.zoho.com.cn/api/xml/listunsubscribe?authtoken=[API Authentication Token]&scope=CampaignsAPI&version=1&resfmt=[XML]&listkey=[listkey ]&contactinfo=<xml><fl val="First Name">mac</fl><fl val="Contact Email">jai@zoho.com</fl></xml>
JSON:
https://campaigns.zoho.com.cn/api/json/listunsubscribe?authtoken=[API Authentication Token]&scope=CampaignsAPI&version=1&resfmt=[JSON]&listkey=[listkey ]&contactinfo={First Name:mac,Last Name:Last Name,Contact Email:jai@zoho.com}
示例响应:
Our API response will let you know of the following be it in the XML or JSON format:
XML 格式
<response uri="/api/xml/listunsubscribe" version="1">
<code>0</code>
<status>success</status>
<message>User successfully unsubscribed.</message>
</response>
JSON 格式
{"message":"User successfully unsubscribed.","status":"success","code":"0","uri":"/api/json/listunsubscribe","version":"1"}
可能出现的错误情况
错误代码 | 描述 |
2101 | 请稍后再试。 |
如果上面没有列出您遇到的错误代码,请单击这里。