source-class-Mandrill_Rejects.html 20 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218
  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  5. <meta name="generator" content="ApiGen 2.8.0" />
  6. <meta name="robots" content="noindex" />
  7. <title>File Mandrill/Rejects.php</title>
  8. <script type="text/javascript" src="resources/combined.js?394153670"></script>
  9. <script type="text/javascript" src="elementlist.js?882160656"></script>
  10. <link rel="stylesheet" type="text/css" media="all" href="resources/style.css?3505392360" />
  11. </head>
  12. <body>
  13. <div id="left">
  14. <div id="menu">
  15. <a href="index.html" title="Overview"><span>Overview</span></a>
  16. <div id="groups">
  17. <h3>Namespaces</h3>
  18. <ul>
  19. <li class="active"><a href="namespace-None.html">None</a>
  20. </li>
  21. <li><a href="namespace-PHP.html">PHP</a>
  22. </li>
  23. </ul>
  24. </div>
  25. <hr />
  26. <div id="elements">
  27. <h3>Classes</h3>
  28. <ul>
  29. <li><a href="class-Mandrill.html">Mandrill</a></li>
  30. <li><a href="class-Mandrill_Exports.html">Mandrill_Exports</a></li>
  31. <li><a href="class-Mandrill_Inbound.html">Mandrill_Inbound</a></li>
  32. <li><a href="class-Mandrill_Internal.html">Mandrill_Internal</a></li>
  33. <li><a href="class-Mandrill_Ips.html">Mandrill_Ips</a></li>
  34. <li><a href="class-Mandrill_Messages.html">Mandrill_Messages</a></li>
  35. <li><a href="class-Mandrill_Metadata.html">Mandrill_Metadata</a></li>
  36. <li class="active"><a href="class-Mandrill_Rejects.html">Mandrill_Rejects</a></li>
  37. <li><a href="class-Mandrill_Senders.html">Mandrill_Senders</a></li>
  38. <li><a href="class-Mandrill_Subaccounts.html">Mandrill_Subaccounts</a></li>
  39. <li><a href="class-Mandrill_Tags.html">Mandrill_Tags</a></li>
  40. <li><a href="class-Mandrill_Templates.html">Mandrill_Templates</a></li>
  41. <li><a href="class-Mandrill_Urls.html">Mandrill_Urls</a></li>
  42. <li><a href="class-Mandrill_Users.html">Mandrill_Users</a></li>
  43. <li><a href="class-Mandrill_Webhooks.html">Mandrill_Webhooks</a></li>
  44. <li><a href="class-Mandrill_Whitelists.html">Mandrill_Whitelists</a></li>
  45. </ul>
  46. <h3>Exceptions</h3>
  47. <ul>
  48. <li><a href="class-Mandrill_Error.html">Mandrill_Error</a></li>
  49. <li><a href="class-Mandrill_HttpError.html">Mandrill_HttpError</a></li>
  50. <li><a href="class-Mandrill_Invalid_CustomDNS.html">Mandrill_Invalid_CustomDNS</a></li>
  51. <li><a href="class-Mandrill_Invalid_CustomDNSPending.html">Mandrill_Invalid_CustomDNSPending</a></li>
  52. <li><a href="class-Mandrill_Invalid_DeleteDefaultPool.html">Mandrill_Invalid_DeleteDefaultPool</a></li>
  53. <li><a href="class-Mandrill_Invalid_DeleteNonEmptyPool.html">Mandrill_Invalid_DeleteNonEmptyPool</a></li>
  54. <li><a href="class-Mandrill_Invalid_EmptyDefaultPool.html">Mandrill_Invalid_EmptyDefaultPool</a></li>
  55. <li><a href="class-Mandrill_Invalid_Key.html">Mandrill_Invalid_Key</a></li>
  56. <li><a href="class-Mandrill_Invalid_Reject.html">Mandrill_Invalid_Reject</a></li>
  57. <li><a href="class-Mandrill_Invalid_Tag_Name.html">Mandrill_Invalid_Tag_Name</a></li>
  58. <li><a href="class-Mandrill_Invalid_Template.html">Mandrill_Invalid_Template</a></li>
  59. <li><a href="class-Mandrill_IP_ProvisionLimit.html">Mandrill_IP_ProvisionLimit</a></li>
  60. <li><a href="class-Mandrill_Metadata_FieldLimit.html">Mandrill_Metadata_FieldLimit</a></li>
  61. <li><a href="class-Mandrill_NoSendingHistory.html">Mandrill_NoSendingHistory</a></li>
  62. <li><a href="class-Mandrill_PaymentRequired.html">Mandrill_PaymentRequired</a></li>
  63. <li><a href="class-Mandrill_PoorReputation.html">Mandrill_PoorReputation</a></li>
  64. <li><a href="class-Mandrill_ServiceUnavailable.html">Mandrill_ServiceUnavailable</a></li>
  65. <li><a href="class-Mandrill_Unknown_Export.html">Mandrill_Unknown_Export</a></li>
  66. <li><a href="class-Mandrill_Unknown_InboundDomain.html">Mandrill_Unknown_InboundDomain</a></li>
  67. <li><a href="class-Mandrill_Unknown_InboundRoute.html">Mandrill_Unknown_InboundRoute</a></li>
  68. <li><a href="class-Mandrill_Unknown_IP.html">Mandrill_Unknown_IP</a></li>
  69. <li><a href="class-Mandrill_Unknown_Message.html">Mandrill_Unknown_Message</a></li>
  70. <li><a href="class-Mandrill_Unknown_MetadataField.html">Mandrill_Unknown_MetadataField</a></li>
  71. <li><a href="class-Mandrill_Unknown_Pool.html">Mandrill_Unknown_Pool</a></li>
  72. <li><a href="class-Mandrill_Unknown_Sender.html">Mandrill_Unknown_Sender</a></li>
  73. <li><a href="class-Mandrill_Unknown_Subaccount.html">Mandrill_Unknown_Subaccount</a></li>
  74. <li><a href="class-Mandrill_Unknown_Template.html">Mandrill_Unknown_Template</a></li>
  75. <li><a href="class-Mandrill_Unknown_TrackingDomain.html">Mandrill_Unknown_TrackingDomain</a></li>
  76. <li><a href="class-Mandrill_Unknown_Url.html">Mandrill_Unknown_Url</a></li>
  77. <li><a href="class-Mandrill_Unknown_Webhook.html">Mandrill_Unknown_Webhook</a></li>
  78. <li><a href="class-Mandrill_ValidationError.html">Mandrill_ValidationError</a></li>
  79. </ul>
  80. </div>
  81. </div>
  82. </div>
  83. <div id="splitter"></div>
  84. <div id="right">
  85. <div id="rightInner">
  86. <form id="search">
  87. <input type="hidden" name="cx" value="" />
  88. <input type="hidden" name="ie" value="UTF-8" />
  89. <input type="text" name="q" class="text" />
  90. <input type="submit" value="Search" />
  91. </form>
  92. <div id="navigation">
  93. <ul>
  94. <li>
  95. <a href="index.html" title="Overview"><span>Overview</span></a>
  96. </li>
  97. <li>
  98. <a href="namespace-None.html" title="Summary of None"><span>Namespace</span></a>
  99. </li>
  100. <li>
  101. <a href="class-Mandrill_Rejects.html" title="Summary of Mandrill_Rejects"><span>Class</span></a>
  102. </li>
  103. </ul>
  104. <ul>
  105. <li>
  106. <a href="tree.html" title="Tree view of classes, interfaces, traits and exceptions"><span>Tree</span></a>
  107. </li>
  108. </ul>
  109. <ul>
  110. </ul>
  111. </div>
  112. <pre><code><span id="1" class="l"><a class="l" href="#1"> 1: </a><span class="xlang">&lt;?php</span>
  113. </span><span id="2" class="l"><a class="l" href="#2"> 2: </a>
  114. </span><span id="3" class="l"><a class="l" href="#3"> 3: </a><span class="php-keyword1">class</span> <a id="Mandrill_Rejects" href="#Mandrill_Rejects">Mandrill_Rejects</a> {
  115. </span><span id="4" class="l"><a class="l" href="#4"> 4: </a> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> <a id="___construct" href="#___construct">__construct</a>(Mandrill <span class="php-var">$master</span>) {
  116. </span><span id="5" class="l"><a class="l" href="#5"> 5: </a> <span class="php-var">$this</span>-&gt;master = <span class="php-var">$master</span>;
  117. </span><span id="6" class="l"><a class="l" href="#6"> 6: </a> }
  118. </span><span id="7" class="l"><a class="l" href="#7"> 7: </a>
  119. </span><span id="8" class="l"><a class="l" href="#8"> 8: </a> <span class="php-comment">/**
  120. </span></span><span id="9" class="l"><a class="l" href="#9"> 9: </a><span class="php-comment"> * Adds an email to your email rejection blacklist. Addresses that you
  121. </span></span><span id="10" class="l"><a class="l" href="#10">10: </a><span class="php-comment">add manually will never expire and there is no reputation penalty
  122. </span></span><span id="11" class="l"><a class="l" href="#11">11: </a><span class="php-comment">for removing them from your blacklist. Attempting to blacklist an
  123. </span></span><span id="12" class="l"><a class="l" href="#12">12: </a><span class="php-comment">address that has been whitelisted will have no effect.
  124. </span></span><span id="13" class="l"><a class="l" href="#13">13: </a><span class="php-comment"> * @param string $email an email address to block
  125. </span></span><span id="14" class="l"><a class="l" href="#14">14: </a><span class="php-comment"> * @param string $comment an optional comment describing the rejection
  126. </span></span><span id="15" class="l"><a class="l" href="#15">15: </a><span class="php-comment"> * @param string $subaccount an optional unique identifier for the subaccount to limit the blacklist entry
  127. </span></span><span id="16" class="l"><a class="l" href="#16">16: </a><span class="php-comment"> * @return struct a status object containing the address and the result of the operation
  128. </span></span><span id="17" class="l"><a class="l" href="#17">17: </a><span class="php-comment"> * - email string the email address you provided
  129. </span></span><span id="18" class="l"><a class="l" href="#18">18: </a><span class="php-comment"> * - added boolean whether the operation succeeded
  130. </span></span><span id="19" class="l"><a class="l" href="#19">19: </a><span class="php-comment"> */</span>
  131. </span><span id="20" class="l"><a class="l" href="#20">20: </a> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> <a id="_add" href="#_add">add</a>(<span class="php-var">$email</span>, <span class="php-var">$comment</span>=<span class="php-keyword1">null</span>, <span class="php-var">$subaccount</span>=<span class="php-keyword1">null</span>) {
  132. </span><span id="21" class="l"><a class="l" href="#21">21: </a> <span class="php-var">$_params</span> = <span class="php-keyword1">array</span>(<span class="php-quote">&quot;email&quot;</span> =&gt; <span class="php-var">$email</span>, <span class="php-quote">&quot;comment&quot;</span> =&gt; <span class="php-var">$comment</span>, <span class="php-quote">&quot;subaccount&quot;</span> =&gt; <span class="php-var">$subaccount</span>);
  133. </span><span id="22" class="l"><a class="l" href="#22">22: </a> <span class="php-keyword1">return</span> <span class="php-var">$this</span>-&gt;master-&gt;call(<span class="php-quote">'rejects/add'</span>, <span class="php-var">$_params</span>);
  134. </span><span id="23" class="l"><a class="l" href="#23">23: </a> }
  135. </span><span id="24" class="l"><a class="l" href="#24">24: </a>
  136. </span><span id="25" class="l"><a class="l" href="#25">25: </a> <span class="php-comment">/**
  137. </span></span><span id="26" class="l"><a class="l" href="#26">26: </a><span class="php-comment"> * Retrieves your email rejection blacklist. You can provide an email
  138. </span></span><span id="27" class="l"><a class="l" href="#27">27: </a><span class="php-comment">address to limit the results. Returns up to 1000 results. By default,
  139. </span></span><span id="28" class="l"><a class="l" href="#28">28: </a><span class="php-comment">entries that have expired are excluded from the results; set
  140. </span></span><span id="29" class="l"><a class="l" href="#29">29: </a><span class="php-comment">include_expired to true to include them.
  141. </span></span><span id="30" class="l"><a class="l" href="#30">30: </a><span class="php-comment"> * @param string $email an optional email address to search by
  142. </span></span><span id="31" class="l"><a class="l" href="#31">31: </a><span class="php-comment"> * @param boolean $include_expired whether to include rejections that have already expired.
  143. </span></span><span id="32" class="l"><a class="l" href="#32">32: </a><span class="php-comment"> * @param string $subaccount an optional unique identifier for the subaccount to limit the blacklist
  144. </span></span><span id="33" class="l"><a class="l" href="#33">33: </a><span class="php-comment"> * @return array Up to 1000 rejection entries
  145. </span></span><span id="34" class="l"><a class="l" href="#34">34: </a><span class="php-comment"> * - return[] struct the information for each rejection blacklist entry
  146. </span></span><span id="35" class="l"><a class="l" href="#35">35: </a><span class="php-comment"> * - email string the email that is blocked
  147. </span></span><span id="36" class="l"><a class="l" href="#36">36: </a><span class="php-comment"> * - reason string the type of event (hard-bounce, soft-bounce, spam, unsub) that caused this rejection
  148. </span></span><span id="37" class="l"><a class="l" href="#37">37: </a><span class="php-comment"> * - detail string extended details about the event, such as the SMTP diagnostic for bounces or the comment for manually-created rejections
  149. </span></span><span id="38" class="l"><a class="l" href="#38">38: </a><span class="php-comment"> * - created_at string when the email was added to the blacklist
  150. </span></span><span id="39" class="l"><a class="l" href="#39">39: </a><span class="php-comment"> * - last_event_at string the timestamp of the most recent event that either created or renewed this rejection
  151. </span></span><span id="40" class="l"><a class="l" href="#40">40: </a><span class="php-comment"> * - expires_at string when the blacklist entry will expire (this may be in the past)
  152. </span></span><span id="41" class="l"><a class="l" href="#41">41: </a><span class="php-comment"> * - expired boolean whether the blacklist entry has expired
  153. </span></span><span id="42" class="l"><a class="l" href="#42">42: </a><span class="php-comment"> * - sender struct the sender that this blacklist entry applies to, or null if none.
  154. </span></span><span id="43" class="l"><a class="l" href="#43">43: </a><span class="php-comment"> * - address string the sender's email address
  155. </span></span><span id="44" class="l"><a class="l" href="#44">44: </a><span class="php-comment"> * - created_at string the date and time that the sender was first seen by Mandrill as a UTC date string in YYYY-MM-DD HH:MM:SS format
  156. </span></span><span id="45" class="l"><a class="l" href="#45">45: </a><span class="php-comment"> * - sent integer the total number of messages sent by this sender
  157. </span></span><span id="46" class="l"><a class="l" href="#46">46: </a><span class="php-comment"> * - hard_bounces integer the total number of hard bounces by messages by this sender
  158. </span></span><span id="47" class="l"><a class="l" href="#47">47: </a><span class="php-comment"> * - soft_bounces integer the total number of soft bounces by messages by this sender
  159. </span></span><span id="48" class="l"><a class="l" href="#48">48: </a><span class="php-comment"> * - rejects integer the total number of rejected messages by this sender
  160. </span></span><span id="49" class="l"><a class="l" href="#49">49: </a><span class="php-comment"> * - complaints integer the total number of spam complaints received for messages by this sender
  161. </span></span><span id="50" class="l"><a class="l" href="#50">50: </a><span class="php-comment"> * - unsubs integer the total number of unsubscribe requests received for messages by this sender
  162. </span></span><span id="51" class="l"><a class="l" href="#51">51: </a><span class="php-comment"> * - opens integer the total number of times messages by this sender have been opened
  163. </span></span><span id="52" class="l"><a class="l" href="#52">52: </a><span class="php-comment"> * - clicks integer the total number of times tracked URLs in messages by this sender have been clicked
  164. </span></span><span id="53" class="l"><a class="l" href="#53">53: </a><span class="php-comment"> * - unique_opens integer the number of unique opens for emails sent for this sender
  165. </span></span><span id="54" class="l"><a class="l" href="#54">54: </a><span class="php-comment"> * - unique_clicks integer the number of unique clicks for emails sent for this sender
  166. </span></span><span id="55" class="l"><a class="l" href="#55">55: </a><span class="php-comment"> * - subaccount string the subaccount that this blacklist entry applies to, or null if none.
  167. </span></span><span id="56" class="l"><a class="l" href="#56">56: </a><span class="php-comment"> */</span>
  168. </span><span id="57" class="l"><a class="l" href="#57">57: </a> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> <a id="_getList" href="#_getList">getList</a>(<span class="php-var">$email</span>=<span class="php-keyword1">null</span>, <span class="php-var">$include_expired</span>=<span class="php-keyword1">false</span>, <span class="php-var">$subaccount</span>=<span class="php-keyword1">null</span>) {
  169. </span><span id="58" class="l"><a class="l" href="#58">58: </a> <span class="php-var">$_params</span> = <span class="php-keyword1">array</span>(<span class="php-quote">&quot;email&quot;</span> =&gt; <span class="php-var">$email</span>, <span class="php-quote">&quot;include_expired&quot;</span> =&gt; <span class="php-var">$include_expired</span>, <span class="php-quote">&quot;subaccount&quot;</span> =&gt; <span class="php-var">$subaccount</span>);
  170. </span><span id="59" class="l"><a class="l" href="#59">59: </a> <span class="php-keyword1">return</span> <span class="php-var">$this</span>-&gt;master-&gt;call(<span class="php-quote">'rejects/list'</span>, <span class="php-var">$_params</span>);
  171. </span><span id="60" class="l"><a class="l" href="#60">60: </a> }
  172. </span><span id="61" class="l"><a class="l" href="#61">61: </a>
  173. </span><span id="62" class="l"><a class="l" href="#62">62: </a> <span class="php-comment">/**
  174. </span></span><span id="63" class="l"><a class="l" href="#63">63: </a><span class="php-comment"> * Deletes an email rejection. There is no limit to how many rejections
  175. </span></span><span id="64" class="l"><a class="l" href="#64">64: </a><span class="php-comment">you can remove from your blacklist, but keep in mind that each deletion
  176. </span></span><span id="65" class="l"><a class="l" href="#65">65: </a><span class="php-comment">has an affect on your reputation.
  177. </span></span><span id="66" class="l"><a class="l" href="#66">66: </a><span class="php-comment"> * @param string $email an email address
  178. </span></span><span id="67" class="l"><a class="l" href="#67">67: </a><span class="php-comment"> * @param string $subaccount an optional unique identifier for the subaccount to limit the blacklist deletion
  179. </span></span><span id="68" class="l"><a class="l" href="#68">68: </a><span class="php-comment"> * @return struct a status object containing the address and whether the deletion succeeded.
  180. </span></span><span id="69" class="l"><a class="l" href="#69">69: </a><span class="php-comment"> * - email string the email address that was removed from the blacklist
  181. </span></span><span id="70" class="l"><a class="l" href="#70">70: </a><span class="php-comment"> * - deleted boolean whether the address was deleted successfully.
  182. </span></span><span id="71" class="l"><a class="l" href="#71">71: </a><span class="php-comment"> * - subaccount string the subaccount blacklist that the address was removed from, if any
  183. </span></span><span id="72" class="l"><a class="l" href="#72">72: </a><span class="php-comment"> */</span>
  184. </span><span id="73" class="l"><a class="l" href="#73">73: </a> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> <span class="php-keyword2">delete</span>(<span class="php-var">$email</span>, <span class="php-var">$subaccount</span>=<span class="php-keyword1">null</span>) {
  185. </span><span id="74" class="l"><a class="l" href="#74">74: </a> <span class="php-var">$_params</span> = <span class="php-keyword1">array</span>(<span class="php-quote">&quot;email&quot;</span> =&gt; <span class="php-var">$email</span>, <span class="php-quote">&quot;subaccount&quot;</span> =&gt; <span class="php-var">$subaccount</span>);
  186. </span><span id="75" class="l"><a class="l" href="#75">75: </a> <span class="php-keyword1">return</span> <span class="php-var">$this</span>-&gt;master-&gt;call(<span class="php-quote">'rejects/delete'</span>, <span class="php-var">$_params</span>);
  187. </span><span id="76" class="l"><a class="l" href="#76">76: </a> }
  188. </span><span id="77" class="l"><a class="l" href="#77">77: </a>
  189. </span><span id="78" class="l"><a class="l" href="#78">78: </a>}
  190. </span><span id="79" class="l"><a class="l" href="#79">79: </a>
  191. </span><span id="80" class="l"><a class="l" href="#80">80: </a>
  192. </span><span id="81" class="l"><a class="l" href="#81">81: </a></span></code></pre>
  193. <div id="footer">
  194. API documentation generated by <a href="http://apigen.org">ApiGen 2.8.0</a>
  195. </div>
  196. </div>
  197. </div>
  198. </body>
  199. </html>