about summary refs log tree commit diff
path: root/docs/Using-the-API
diff options
context:
space:
mode:
authorChristian Walde <walde.christian@googlemail.com>2017-01-26 16:27:16 +0100
committerChristian Walde <walde.christian@googlemail.com>2017-01-26 16:28:57 +0100
commit12eddb5cbe4536f403657a91d3775240cdada5b9 (patch)
tree4299cf61472ae9de7b9616d853d59348952ec77d /docs/Using-the-API
parentcc5c1e5febf588183145e30dc7e98e5ea33cd398 (diff)
document that /oauth/token does not always return json
Diffstat (limited to 'docs/Using-the-API')
-rw-r--r--docs/Using-the-API/Testing-with-cURL.md4
1 files changed, 3 insertions, 1 deletions
diff --git a/docs/Using-the-API/Testing-with-cURL.md b/docs/Using-the-API/Testing-with-cURL.md
index 977773a08..dc5f2022d 100644
--- a/docs/Using-the-API/Testing-with-cURL.md
+++ b/docs/Using-the-API/Testing-with-cURL.md
@@ -9,7 +9,9 @@ From these two, you will need to acquire an access token. It is possible to do u
 
     curl -X POST -d "client_id=CLIENT_ID_HERE&client_secret=CLIENT_SECRET_HERE&grant_type=password&username=YOUR_EMAIL&password=YOUR_PASSWORD" -Ss https://mastodon.social/oauth/token
 
-The response will be a JSON object containing the key `access_token`. Use that token in any API requests by setting a header like this:
+The `/oauth/token` path will attempt to login with the given credentials, and then retrieve the access token for the current user. If the login failed the response will be a 302 redirect to `/auth/sign_in`. Otherwise the response will be a JSON object containing the key `access_token`.
+
+Use that token in any API requests by setting a header like this:
 
     curl --header "Authorization: Bearer ACCESS_TOKEN_HERE" -sS https://mastodon.social/api/statuses/home