March 2013 / Release 8.1 API Updates

[jesse]

Along side our 8.1 release this week, there are a few API updates/tweaks that have rolled out as well. Let's have a look:

OAuth2 Wildcard Domain support
For people with multi-datacenter or custom sub-domain setups for their users, it was always simple enough to redirect folks around their top level domains and back down to them (we've done it for several of our own integrations), but some people really hated the extra step. So, starting 2013-03-25 we automatically enabled wildcard domain support for our OAuth2 authorization endpoint. Basically what that means is that if you have a redirect_uri of https://mydomain.com configured, we'll now accept https://user1.mydomain.com/ , https://user2.mydomain.com/ , etc. as matching and then use that as the redirect_uri to get you directly back to the subdomain you want. There are some logical TLD restrictions (think co.uk) that you're unlikely to hit - full details in the docs

Export API updates

• campaignSubscriberActivity() now supports a "since" parameter for pulling incremental campaign stats. Yay. And take this time to remind yourself that it's pretty useless to pull stats for campaigns over about a week or two old.
• a new ecommOrders() method was added for simple/quick dumping of all Ecommerce orders in an account along with an optional "since" parameter
  

Notessssssssss
If you read the 8.1 blog post at the top, there's a little background on the "notes" field support for subscriber profiles. We quietly added a "MC_NOTES" special merge var a while back and started returning "notes" in listMemberInfo() style data a while back, but purposefully never talked about it as there was a sneaky supspicion we'd move from single notes to multiple notes. And we did. So the MC_NOTES parameter documentation has been updated for managing multiple notes, which has also caused extra notes data (id, created_by_name) t0 be included in listMemberInfo() data.

It's been made as backwards compatible as it could be, but here's what changed:

• Doing nothing to a call using MC_NOTES will simply keep adding notes to an account - the "update" param is ignored until we see an "id" key
• listMemberInfo() already returned "notes" as an array (yay), just only ever with a single entry. Now you'll get more entries along with the additional data noted.

jesse