获取营销推广收件人数据
用户可以使用我们的API身份验证令牌获取营销推广活动的收件人数据。
请求 URL
XML/ JSON
https://campaigns.zoho.com.cn/api/getcampaignrecipientsdata
请求类型： Post
参数列表
参数 | 数据类型 | 描述 |
authtoken* | 字符串 | API 身份验证令牌 |
version | 字符串 | 这将基于当前API版本获取响应。 |
resfmt | 字符串 | XML (或) JSON |
campaignkey* | 字符串 | [campaignkey] |
action* | 字符串 | [sentcontacts|openedcontacts|optoutcontacts|spamcontacts |unopenedcontacts|clickedcontacts|senthardbounce| sentsoftbounce|unsentcontacts] |
* - 必填参数
示例请求：
XML/ JSON
https://campaigns.zoho.com.cn/api/getcampaignrecipientsdata?authtoken=[API Authentication Token]&scope=CampaignsAPI&campaignkey=[campaignkey]&action=[sentcontacts|openedcontacts|optoutcontacts|spamcontacts|unopenedcontacts|clickedcontacts|senthardbounce| sentsoftbounce|unsentcontacts]&resfmt=[XML|JSON]
示例响应：
我们的API响应将以XML或JSON格式让您了解以下内容。
XML 格式：
<response uri="/api/getcampaignrecipientsdata" version="1">
<status>success</status>
<code>0</code>
<range>20</range>
<action>sentcontacts</action>
<fromindex>1</fromindex>
<campaign_details>
<fl val="email_status">Sent</fl>
<fl val="zuid">4179027</fl>
<fl val="campaign_name">Zoho Survey 7</fl>
<fl val="email_subject">Zoho Survey 7</fl>
</campaign_details>
<contacts>
<contact>
<fl val="added_time">02 Aug 2013, 12:39 PM</fl>
<fl val="first_name">meganath.v</fl>
<fl val="last_name"/>
<fl val="company_name"/>
<fl val="phone"/>
<fl val="contact_email">john.doe@xyz.com</fl>
</contact>
</contacts>
</response>
JSON 格式：
{"requestdetails":{"range":20,"action":"sentcontacts","fromindex":1},"status":"success","list_of_details":[{"phone":"null","timezone":"null","contactstatus":"active","contactemailaddress":"john.doe@xyz.com","sent_time":"1375456161000","lastname":"","sentdate":"02 Aug 2013, 12:39 PM","firstname":"meganath.v","contactid":"303000014269257","companyname":"null"}],"code":"0","uri":"/api/getcampaignrecipientsdata","version":"1"}
可能出现的错误情况：
| 错误代码 | 描述 |
| 6601 | AB营销推广活动应至少发送给4个收件人。 |
| 6607 | 执行此操作的权限不足。请联系机构管理员。 |
| 6303 | 所选邮件列表中没有订阅者。 |
| 6002 | 无效的营销推广活动密钥(或)营销推广活动尚未发送。 |
如果上面没有列出您遇到的错误代码，请单击这里。