class-Mandrill_Users.html 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458
  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. <title>Class Mandrill_Users</title>
  7. <script type="text/javascript" src="resources/combined.js?394153670"></script>
  8. <script type="text/javascript" src="elementlist.js?882160656"></script>
  9. <link rel="stylesheet" type="text/css" media="all" href="resources/style.css?3505392360" />
  10. </head>
  11. <body>
  12. <div id="left">
  13. <div id="menu">
  14. <a href="index.html" title="Overview"><span>Overview</span></a>
  15. <div id="groups">
  16. <h3>Namespaces</h3>
  17. <ul>
  18. <li class="active"><a href="namespace-None.html">None</a>
  19. </li>
  20. <li><a href="namespace-PHP.html">PHP</a>
  21. </li>
  22. </ul>
  23. </div>
  24. <hr />
  25. <div id="elements">
  26. <h3>Classes</h3>
  27. <ul>
  28. <li><a href="class-Mandrill.html">Mandrill</a></li>
  29. <li><a href="class-Mandrill_Exports.html">Mandrill_Exports</a></li>
  30. <li><a href="class-Mandrill_Inbound.html">Mandrill_Inbound</a></li>
  31. <li><a href="class-Mandrill_Internal.html">Mandrill_Internal</a></li>
  32. <li><a href="class-Mandrill_Ips.html">Mandrill_Ips</a></li>
  33. <li><a href="class-Mandrill_Messages.html">Mandrill_Messages</a></li>
  34. <li><a href="class-Mandrill_Metadata.html">Mandrill_Metadata</a></li>
  35. <li><a href="class-Mandrill_Rejects.html">Mandrill_Rejects</a></li>
  36. <li><a href="class-Mandrill_Senders.html">Mandrill_Senders</a></li>
  37. <li><a href="class-Mandrill_Subaccounts.html">Mandrill_Subaccounts</a></li>
  38. <li><a href="class-Mandrill_Tags.html">Mandrill_Tags</a></li>
  39. <li><a href="class-Mandrill_Templates.html">Mandrill_Templates</a></li>
  40. <li><a href="class-Mandrill_Urls.html">Mandrill_Urls</a></li>
  41. <li class="active"><a href="class-Mandrill_Users.html">Mandrill_Users</a></li>
  42. <li><a href="class-Mandrill_Webhooks.html">Mandrill_Webhooks</a></li>
  43. <li><a href="class-Mandrill_Whitelists.html">Mandrill_Whitelists</a></li>
  44. </ul>
  45. <h3>Exceptions</h3>
  46. <ul>
  47. <li><a href="class-Mandrill_Error.html">Mandrill_Error</a></li>
  48. <li><a href="class-Mandrill_HttpError.html">Mandrill_HttpError</a></li>
  49. <li><a href="class-Mandrill_Invalid_CustomDNS.html">Mandrill_Invalid_CustomDNS</a></li>
  50. <li><a href="class-Mandrill_Invalid_CustomDNSPending.html">Mandrill_Invalid_CustomDNSPending</a></li>
  51. <li><a href="class-Mandrill_Invalid_DeleteDefaultPool.html">Mandrill_Invalid_DeleteDefaultPool</a></li>
  52. <li><a href="class-Mandrill_Invalid_DeleteNonEmptyPool.html">Mandrill_Invalid_DeleteNonEmptyPool</a></li>
  53. <li><a href="class-Mandrill_Invalid_EmptyDefaultPool.html">Mandrill_Invalid_EmptyDefaultPool</a></li>
  54. <li><a href="class-Mandrill_Invalid_Key.html">Mandrill_Invalid_Key</a></li>
  55. <li><a href="class-Mandrill_Invalid_Reject.html">Mandrill_Invalid_Reject</a></li>
  56. <li><a href="class-Mandrill_Invalid_Tag_Name.html">Mandrill_Invalid_Tag_Name</a></li>
  57. <li><a href="class-Mandrill_Invalid_Template.html">Mandrill_Invalid_Template</a></li>
  58. <li><a href="class-Mandrill_IP_ProvisionLimit.html">Mandrill_IP_ProvisionLimit</a></li>
  59. <li><a href="class-Mandrill_Metadata_FieldLimit.html">Mandrill_Metadata_FieldLimit</a></li>
  60. <li><a href="class-Mandrill_NoSendingHistory.html">Mandrill_NoSendingHistory</a></li>
  61. <li><a href="class-Mandrill_PaymentRequired.html">Mandrill_PaymentRequired</a></li>
  62. <li><a href="class-Mandrill_PoorReputation.html">Mandrill_PoorReputation</a></li>
  63. <li><a href="class-Mandrill_ServiceUnavailable.html">Mandrill_ServiceUnavailable</a></li>
  64. <li><a href="class-Mandrill_Unknown_Export.html">Mandrill_Unknown_Export</a></li>
  65. <li><a href="class-Mandrill_Unknown_InboundDomain.html">Mandrill_Unknown_InboundDomain</a></li>
  66. <li><a href="class-Mandrill_Unknown_InboundRoute.html">Mandrill_Unknown_InboundRoute</a></li>
  67. <li><a href="class-Mandrill_Unknown_IP.html">Mandrill_Unknown_IP</a></li>
  68. <li><a href="class-Mandrill_Unknown_Message.html">Mandrill_Unknown_Message</a></li>
  69. <li><a href="class-Mandrill_Unknown_MetadataField.html">Mandrill_Unknown_MetadataField</a></li>
  70. <li><a href="class-Mandrill_Unknown_Pool.html">Mandrill_Unknown_Pool</a></li>
  71. <li><a href="class-Mandrill_Unknown_Sender.html">Mandrill_Unknown_Sender</a></li>
  72. <li><a href="class-Mandrill_Unknown_Subaccount.html">Mandrill_Unknown_Subaccount</a></li>
  73. <li><a href="class-Mandrill_Unknown_Template.html">Mandrill_Unknown_Template</a></li>
  74. <li><a href="class-Mandrill_Unknown_TrackingDomain.html">Mandrill_Unknown_TrackingDomain</a></li>
  75. <li><a href="class-Mandrill_Unknown_Url.html">Mandrill_Unknown_Url</a></li>
  76. <li><a href="class-Mandrill_Unknown_Webhook.html">Mandrill_Unknown_Webhook</a></li>
  77. <li><a href="class-Mandrill_ValidationError.html">Mandrill_ValidationError</a></li>
  78. </ul>
  79. </div>
  80. </div>
  81. </div>
  82. <div id="splitter"></div>
  83. <div id="right">
  84. <div id="rightInner">
  85. <form id="search">
  86. <input type="hidden" name="cx" value="" />
  87. <input type="hidden" name="ie" value="UTF-8" />
  88. <input type="text" name="q" class="text" />
  89. <input type="submit" value="Search" />
  90. </form>
  91. <div id="navigation">
  92. <ul>
  93. <li>
  94. <a href="index.html" title="Overview"><span>Overview</span></a>
  95. </li>
  96. <li>
  97. <a href="namespace-None.html" title="Summary of None"><span>Namespace</span></a>
  98. </li>
  99. <li class="active">
  100. <span>Class</span> </li>
  101. </ul>
  102. <ul>
  103. <li>
  104. <a href="tree.html" title="Tree view of classes, interfaces, traits and exceptions"><span>Tree</span></a>
  105. </li>
  106. </ul>
  107. <ul>
  108. </ul>
  109. </div>
  110. <div id="content" class="class">
  111. <h1>Class Mandrill_Users</h1>
  112. <div class="info">
  113. <b>Located at</b> <a href="source-class-Mandrill_Users.html#3-130" title="Go to source code">Mandrill/Users.php</a><br />
  114. </div>
  115. <table class="summary" id="methods">
  116. <caption>Methods summary</caption>
  117. <tr data-order="__construct" id="___construct">
  118. <td class="attributes"><code>
  119. public
  120. </code>
  121. </td>
  122. <td class="name"><div>
  123. <a class="anchor" href="#___construct">#</a>
  124. <code><a href="source-class-Mandrill_Users.html#4-6" title="Go to source code">__construct</a>( <span><code><a href="class-Mandrill.html">Mandrill</a></code> <var>$master</var></span> )</code>
  125. <div class="description short">
  126. </div>
  127. <div class="description detailed hidden">
  128. </div>
  129. </div></td>
  130. </tr>
  131. <tr data-order="info" id="_info">
  132. <td class="attributes"><code>
  133. public
  134. struct
  135. </code>
  136. </td>
  137. <td class="name"><div>
  138. <a class="anchor" href="#_info">#</a>
  139. <code><a href="source-class-Mandrill_Users.html#8-88" title="Go to source code">info</a>( )</code>
  140. <div class="description short">
  141. <p>Return the information about the API-connected user</p>
  142. </div>
  143. <div class="description detailed hidden">
  144. <p>Return the information about the API-connected user</p>
  145. <h4>Returns</h4>
  146. <div class="list">
  147. <code>struct</code><br>the user information including username, key, reputation, quota, and historical
  148. sending stats - username string the username of the user (used for SMTP
  149. authentication) - created_at string the date and time that the user's Mandrill
  150. account was created as a UTC string in YYYY-MM-DD HH:MM:SS format - public_id
  151. string a unique, permanent identifier for this user - reputation integer the
  152. reputation of the user on a scale from 0 to 100, with 75 generally being a
  153. "good" reputation - hourly_quota integer the maximum number of emails Mandrill
  154. will deliver for this user each hour. Any emails beyond that will be accepted
  155. and queued for later delivery. Users with higher reputations will have higher
  156. hourly quotas - backlog integer the number of emails that are queued for
  157. delivery due to exceeding your monthly or hourly quotas - stats struct an
  158. aggregate summary of the account's sending stats - today struct stats for this
  159. user so far today - sent integer the number of emails sent for this user so far
  160. today - hard_bounces integer the number of emails hard bounced for this user so
  161. far today - soft_bounces integer the number of emails soft bounced for this user
  162. so far today - rejects integer the number of emails rejected for sending this
  163. user so far today - complaints integer the number of spam complaints for this
  164. user so far today - unsubs integer the number of unsubscribes for this user so
  165. far today - opens integer the number of times emails have been opened for this
  166. user so far today - unique_opens integer the number of unique opens for emails
  167. sent for this user so far today - clicks integer the number of URLs that have
  168. been clicked for this user so far today - unique_clicks integer the number of
  169. unique clicks for emails sent for this user so far today - last<sub>7</sub>_days
  170. struct stats for this user in the last 7 days - sent integer the number of
  171. emails sent for this user in the last 7 days - hard_bounces integer the number
  172. of emails hard bounced for this user in the last 7 days - soft_bounces integer
  173. the number of emails soft bounced for this user in the last 7 days - rejects
  174. integer the number of emails rejected for sending this user in the last 7 days -
  175. complaints integer the number of spam complaints for this user in the last 7
  176. days - unsubs integer the number of unsubscribes for this user in the last 7
  177. days - opens integer the number of times emails have been opened for this user
  178. in the last 7 days - unique_opens integer the number of unique opens for emails
  179. sent for this user in the last 7 days - clicks integer the number of URLs that
  180. have been clicked for this user in the last 7 days - unique_clicks integer the
  181. number of unique clicks for emails sent for this user in the last 7 days -
  182. last<sub>30</sub>_days struct stats for this user in the last 30 days - sent
  183. integer the number of emails sent for this user in the last 30 days -
  184. hard_bounces integer the number of emails hard bounced for this user in the last
  185. 30 days - soft_bounces integer the number of emails soft bounced for this user
  186. in the last 30 days - rejects integer the number of emails rejected for sending
  187. this user in the last 30 days - complaints integer the number of spam complaints
  188. for this user in the last 30 days - unsubs integer the number of unsubscribes
  189. for this user in the last 30 days - opens integer the number of times emails
  190. have been opened for this user in the last 30 days - unique_opens integer the
  191. number of unique opens for emails sent for this user in the last 30 days -
  192. clicks integer the number of URLs that have been clicked for this user in the
  193. last 30 days - unique_clicks integer the number of unique clicks for emails sent
  194. for this user in the last 30 days - last<sub>60</sub>_days struct stats for this
  195. user in the last 60 days - sent integer the number of emails sent for this user
  196. in the last 60 days - hard_bounces integer the number of emails hard bounced for
  197. this user in the last 60 days - soft_bounces integer the number of emails soft
  198. bounced for this user in the last 60 days - rejects integer the number of emails
  199. rejected for sending this user in the last 60 days - complaints integer the
  200. number of spam complaints for this user in the last 60 days - unsubs integer the
  201. number of unsubscribes for this user in the last 60 days - opens integer the
  202. number of times emails have been opened for this user in the last 60 days -
  203. unique_opens integer the number of unique opens for emails sent for this user in
  204. the last 60 days - clicks integer the number of URLs that have been clicked for
  205. this user in the last 60 days - unique_clicks integer the number of unique
  206. clicks for emails sent for this user in the last 60 days -
  207. last<sub>90</sub>_days struct stats for this user in the last 90 days - sent
  208. integer the number of emails sent for this user in the last 90 days -
  209. hard_bounces integer the number of emails hard bounced for this user in the last
  210. 90 days - soft_bounces integer the number of emails soft bounced for this user
  211. in the last 90 days - rejects integer the number of emails rejected for sending
  212. this user in the last 90 days - complaints integer the number of spam complaints
  213. for this user in the last 90 days - unsubs integer the number of unsubscribes
  214. for this user in the last 90 days - opens integer the number of times emails
  215. have been opened for this user in the last 90 days - unique_opens integer the
  216. number of unique opens for emails sent for this user in the last 90 days -
  217. clicks integer the number of URLs that have been clicked for this user in the
  218. last 90 days - unique_clicks integer the number of unique clicks for emails sent
  219. for this user in the last 90 days - all_time struct stats for the lifetime of
  220. the user's account - sent integer the number of emails sent in the lifetime of
  221. the user's account - hard_bounces integer the number of emails hard bounced in
  222. the lifetime of the user's account - soft_bounces integer the number of emails
  223. soft bounced in the lifetime of the user's account - rejects integer the number
  224. of emails rejected for sending this user so far today - complaints integer the
  225. number of spam complaints in the lifetime of the user's account - unsubs integer
  226. the number of unsubscribes in the lifetime of the user's account - opens integer
  227. the number of times emails have been opened in the lifetime of the user's
  228. account - unique_opens integer the number of unique opens for emails sent in the
  229. lifetime of the user's account - clicks integer the number of URLs that have
  230. been clicked in the lifetime of the user's account - unique_clicks integer the
  231. number of unique clicks for emails sent in the lifetime of the user's account<br />
  232. </div>
  233. </div>
  234. </div></td>
  235. </tr>
  236. <tr data-order="ping" id="_ping">
  237. <td class="attributes"><code>
  238. public
  239. string
  240. </code>
  241. </td>
  242. <td class="name"><div>
  243. <a class="anchor" href="#_ping">#</a>
  244. <code><a href="source-class-Mandrill_Users.html#90-97" title="Go to source code">ping</a>( )</code>
  245. <div class="description short">
  246. <p>Validate an API key and respond to a ping</p>
  247. </div>
  248. <div class="description detailed hidden">
  249. <p>Validate an API key and respond to a ping</p>
  250. <h4>Returns</h4>
  251. <div class="list">
  252. <code>string</code><br>the string "PONG!"<br />
  253. </div>
  254. </div>
  255. </div></td>
  256. </tr>
  257. <tr data-order="ping2" id="_ping2">
  258. <td class="attributes"><code>
  259. public
  260. struct
  261. </code>
  262. </td>
  263. <td class="name"><div>
  264. <a class="anchor" href="#_ping2">#</a>
  265. <code><a href="source-class-Mandrill_Users.html#99-106" title="Go to source code">ping2</a>( )</code>
  266. <div class="description short">
  267. <p>Validate an API key and respond to a ping (anal JSON parser version)</p>
  268. </div>
  269. <div class="description detailed hidden">
  270. <p>Validate an API key and respond to a ping (anal JSON parser version)</p>
  271. <h4>Returns</h4>
  272. <div class="list">
  273. <code>struct</code><br>a struct with one key "PING" with a static value "PONG!"<br />
  274. </div>
  275. </div>
  276. </div></td>
  277. </tr>
  278. <tr data-order="senders" id="_senders">
  279. <td class="attributes"><code>
  280. public
  281. array
  282. </code>
  283. </td>
  284. <td class="name"><div>
  285. <a class="anchor" href="#_senders">#</a>
  286. <code><a href="source-class-Mandrill_Users.html#108-128" title="Go to source code">senders</a>( )</code>
  287. <div class="description short">
  288. <p>Return the senders that have tried to use this account, both verified and
  289. unverified</p>
  290. </div>
  291. <div class="description detailed hidden">
  292. <p>Return the senders that have tried to use this account, both verified and
  293. unverified</p>
  294. <h4>Returns</h4>
  295. <div class="list">
  296. <code>array</code><br>an array of sender data, one for each sending addresses used by the account -
  297. return[] struct the information on each sending address in the account - address
  298. string the sender's email address - created_at string the date and time that the
  299. sender was first seen by Mandrill as a UTC date string in YYYY-MM-DD HH:MM:SS
  300. format - sent integer the total number of messages sent by this sender -
  301. hard_bounces integer the total number of hard bounces by messages by this sender
  302. - soft_bounces integer the total number of soft bounces by messages by this
  303. sender - rejects integer the total number of rejected messages by this sender -
  304. complaints integer the total number of spam complaints received for messages by
  305. this sender - unsubs integer the total number of unsubscribe requests received
  306. for messages by this sender - opens integer the total number of times messages
  307. by this sender have been opened - clicks integer the total number of times
  308. tracked URLs in messages by this sender have been clicked - unique_opens integer
  309. the number of unique opens for emails sent for this sender - unique_clicks
  310. integer the number of unique clicks for emails sent for this sender<br />
  311. </div>
  312. </div>
  313. </div></td>
  314. </tr>
  315. </table>
  316. </div>
  317. <div id="footer">
  318. API documentation generated by <a href="http://apigen.org">ApiGen 2.8.0</a>
  319. </div>
  320. </div>
  321. </div>
  322. </body>
  323. </html>