{"id":1142,"date":"2018-07-16T08:59:31","date_gmt":"2018-07-16T15:59:31","guid":{"rendered":"https:\/\/directmailmac.com\/blog\/?p=1142"},"modified":"2018-07-17T07:18:41","modified_gmt":"2018-07-17T14:18:41","slug":"api-update","status":"publish","type":"post","link":"https:\/\/directmailmac.com\/blog\/2018\/07\/api-update\/","title":{"rendered":"July 2018 API Update"},"content":{"rendered":"<p><em>This is a technical blog post for consumers of our <a href=\"\/api\">Direct Mail API<\/a>. If you would like to receive email notifications each time our API is updated, please <a href=\"https:\/\/dm-mailinglist.com\/subscribe?f=2fbe6238\">sign up here<\/a>.<\/em><\/p>\n<p>If you currently use our API, we want to make you aware of some minor, non-breaking changes that rolled out this week in conjunction with our Direct Mail 5.3 update.\u00a0In order to help our users comply with lawful data erasure requests that they may receive from EU citizens, Direct Mail is now able, upon user request, to delete and anonymize campaign report data specific to a particular individual. This has implications for consumers of our API:<\/p>\n<ul>\n<li>The JSON object that represents a <a href=\"https:\/\/directmailmac.com\/support\/article\/470\">campaign report recipient<\/a> now has an additional boolean property named <em>anonymized<\/em>. If this property is <em>true<\/em>, it means that the information for the recipient has been anonymized\/deleted, and you will find that other properties on the JSON object (e.g. email, bounce reason, etc.) are <em>null<\/em> or <em>false<\/em>, so as not to reveal information about the recipient.<\/li>\n<li>The JSON object that represents a <a href=\"https:\/\/directmailmac.com\/support\/article\/470\">campaign report recipient<\/a> has always included links to resources related to that recipient, including <em>archived-address<\/em>, <em>live-address<\/em>, <em>opens<\/em>, and <em>clicks<\/em>. If the recipient has been anonymized, those linked resources will be anonymized (as in the case of <em>archived-address<\/em>), return 404 not found (as in the case of <em>live-address<\/em>), or return empty data sets (as in the case of <em>opens<\/em> and <em>clicks<\/em>)<\/li>\n<li>It is now possible for the number of reported opens, clicks, bounces, unsubscribes, etc. for a campaign to <em>decrease<\/em> over time. This is only possible in the case that the Direct Mail user chooses to delete data for a particular individual.<\/li>\n<\/ul>\n<p>We do not anticipate that the above changes will break anyone\u2019s use of the API. This information may be useful as you update your own business processes and software to be compatible with privacy law changes around the world.<\/p>\n<p>If you have any questions or concerns, please don\u2019t hesitate to contact our support team.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>This is a technical blog post for consumers of our Direct Mail API. If you would like to receive email notifications each time our API is updated, please sign up here. If you currently use&hellip;<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[11],"tags":[],"class_list":["post-1142","post","type-post","status-publish","format-standard","hentry","category-announcements"],"_links":{"self":[{"href":"https:\/\/directmailmac.com\/blog\/wp-json\/wp\/v2\/posts\/1142","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/directmailmac.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/directmailmac.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/directmailmac.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/directmailmac.com\/blog\/wp-json\/wp\/v2\/comments?post=1142"}],"version-history":[{"count":2,"href":"https:\/\/directmailmac.com\/blog\/wp-json\/wp\/v2\/posts\/1142\/revisions"}],"predecessor-version":[{"id":1144,"href":"https:\/\/directmailmac.com\/blog\/wp-json\/wp\/v2\/posts\/1142\/revisions\/1144"}],"wp:attachment":[{"href":"https:\/\/directmailmac.com\/blog\/wp-json\/wp\/v2\/media?parent=1142"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/directmailmac.com\/blog\/wp-json\/wp\/v2\/categories?post=1142"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/directmailmac.com\/blog\/wp-json\/wp\/v2\/tags?post=1142"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}