获取分段订阅者
用户可以使用我们的API获取分段订阅者。
请求 URL
您可以选择在请求时使用XML(或)JSON格式。
XML/ JSON
https://campaigns.zoho.com.cn/api/getsegmentcontacts
请求类型： Get/ Post
参数列表
参数 | 数据类型 | 描述 |
authtoken* | 字符串 | API 身份验证令牌 |
version | 字符串 | 这将基于当前API版本获取响应。 |
resfmt | 字符串 | XML (或) JSON |
cvid*
| 数字 | 您将从getmailinglists获得cvid。 |
* - 必填参数
示例请求：
XML/ JSON:
https://campaigns.zoho.com//api/getsegmentcontacts?authtoken=[API Authentication Token]&scope=CampaignsAPI&cvid=[cvid]&resfmt=[XML/JSON]
示例响应：
我们的API响应将以XML或JSON格式让您了解以下内容。
XML 格式：
<response uri="/api/getsegmentcontacts" version="1">
<status>success</status>
<code>0</code>
<range>20</range>
<cvid>303000014567003</cvid>
<fromindex>1</fromindex>
<segment_contacts>
<contact>
<fl val="contact_email">user512@thandora.com</fl>
<fl val="firstname"/>
<fl val="lastname"/>
<fl val="companyname"/>
<fl val="added_time">22 Apr 2011, 04:37 PM</fl>
<fl val="phone"/>
</contact>
<contact>
<fl val="contact_email">user212@thandora.com</fl>
<fl val="firstname"/>
<fl val="lastname"/>
<fl val="companyname"/>
<fl val="added_time">22 Apr 2011, 04:37 PM</fl>
<fl val="phone"/>
</contact>
<contact>
<fl val="contact_email">user612@thandora.com</fl>
<fl val="firstname"/>
<fl val="lastname"/>
<fl val="companyname"/>
<fl val="added_time">22 Apr 2011, 04:37 PM</fl>
<fl val="phone"/>
</contact>
<contact>
<fl val="contact_email">user118@thandora.com</fl>
<fl val="firstname">changefname users</fl>
<fl val="lastname">users</fl>
<fl val="companyname"/>
<fl val="added_time">16 Apr 2011, 09:00 PM</fl>
<fl val="phone"/>
</contact>
</segment_contacts>
</response>JSON 格式：
{"requestdetails":{"range":20,"cvid":303000023471055,"fromindex":1},"status":"success","list_of_details":[{"phone":"","contact_email":"hhh@dsd.com","lastname":"","firstname":"","companyname":""}],"code":"0","uri":"/api/getsegmentcontacts","version":"1"}
可能出现的错误情况
| 错误代码 | 描述 |
| 903 | 缺少必填字段。 |
| 2202 | Listkey为空或无效。 |
| 2603 | 获取分段信息时出错。请稍后再试。 |
| 2604 | 在这个分段中没有订阅者。 |
如果上面没有列出您遇到的错误代码，请单击这里。