This is intended for developers who are currently using the Battle.net API via Mashery, and need to migrate to Blizzard's own Battle.net API.
The official migration documentation is here but it's wordy and scattered. This document intends to cut the BS for existing developers as a true migration guide.
It's organized into sections based on the different kinds of API calls.
This was written with World of Warcraft APIs in mind. While our hostnames are changing, none of WoW's API paths will change. However, some Starcraft II paths will change, so please reference Blizzard's documentation for further information about that.