获取邮件列表
用户可以使用我们的API身份验证令牌获取邮件列表,并且会自动通知。
请求 URL
XML/ JSON
https://campaigns.zoho.com.cn/api/getmailinglists
请求类型: Post
参数列表
参数 | 数据类型 | 描述 |
authtoken* | 字符串 | API 身份验证令牌 |
version | 字符串 | 这将基于当前API版本获取响应。 |
resfmt | 字符串 | XML (或) JSON |
sort | 字符串 | asc/desc |
fromindex | 数字 | 以数字表示的数值。 |
range | 数字 | 以数字表示的数值。 |
* - 必填参数
示例请求:
XML/ JSON:
https://campaigns.zoho.com.cn/api/getmailinglists?authtoken=[API Authentication Token]&scope=CampaignsAPI&sort=[asc/desc]&fromindex=[number]&range=[number]&resfmt=[XML/JSON]
示例响应:
我们的API响应将以XML或JSON格式让您了解以下内容。
XML 格式:
<response uri="/api/getmailinglists" version="1">
<status>success</status>
<code>0</code>
<sort>Ascending Order</sort>
<range>2</range>
<fromindex>1</fromindex>
<list_of_details>
<list>
<fl val="created_date">1316108278000</fl>
<fl val="listunino">6361736964559881</fl>
<fl val="noofbouncecnt">0</fl>
<fl val="segments"/>
<fl val="lockstatus">unlocked</fl>
<fl val="is_public">false</fl>
<fl val="zuid">229788</fl>
<fl val="noofunsubcnt">0</fl>
<fl val="owner">Naveen</fl>
<fl val="listkey">3c20ad524dfa4af86216a5be13e238ed</fl>
<fl val="listname">1</fl>
<fl val="noofcontacts">57</fl>
</list>
<list>
<fl val="created_date">1358908439000</fl>
<fl val="listunino">6361736976335832</fl>
<fl val="noofbouncecnt">0</fl>
<fl val="segments"/>
<fl val="lockstatus">unlocked</fl>
<fl val="is_public">true</fl>
<fl val="zuid">8846468</fl>
<fl val="noofunsubcnt">2</fl>
<fl val="owner">john.doe</fl>
<fl val="listkey">3c20ad524dfa4af85c20ad3564a05789</fl>
<fl val="listname">111</fl>
<fl val="noofcontacts">1393</fl>
</list>
</list_of_details>
</response>
JSON 格式:
{"requestdetails":{"sort":"Ascending Order","range":2,"fromindex":1},"status":"success","list_of_details":[{"created_date":"1316108278000","segments":"{}","lockstatus":"unlocked","listunino":"6361736964559881","date":"15 Sep 2011, 03:07 PM","noofcontacts":"57","listname":"1","zuid":"229788","noofunsubcnt":"0","is_public":"false","noofbouncecnt":"0","owner":"Naveen","listkey":"3c20ad524dfa4af86216a5be13e238ed"},{"created_date":"1358908439000","segments":"{}","lockstatus":"unlocked","listunino":"6361736976335832","date":"23 Jan 2013, 12:03 AM","noofcontacts":"1393","listname":"111","zuid":"8846468","noofunsubcnt":"2","is_public":"true","noofbouncecnt":"0","owner":"john.doe.b","listkey":"3c20ad524dfa4af85c20ad3564a05789"}],"code":"0","uri":"/api/getmailinglists","version":"1"}
可能出现的错误情况
错误代码 | 描述 |
1004 | 无法找到您正在寻找的资源。请重新检查文件并重试。 |
2706 | 访问列表的权限不足。 |
2402 | 显示细节错误。请稍后再试。. |
2401 | 没有创建邮件列表。请创建一个列表。 |
如果上面没有列出您遇到的错误代码,请单击这里。