The docs should give much greater prominence to this page:
This explains the authentication process a lot more clearly, and should be required reading for anyone thinking about using the APIs. There’s a lot of very important information there about how to use the service correctly (and responsibly). Unfortunately, this link is buried half-way down the developers page, when it should really be one of the first things you see on the main API reference page.