Documented example responses to most of the api, and fixed some places where url_for doesn't have _external=True #18