api: Update readme.

R=golang-dev, bradfitz, dave
CC=golang-dev
https://codereview.appspot.com/7303065

Committer: Brad Fitzpatrick <bradfitz@golang.org>