Token#
When?#
When you’re working with Kitsu.io API, you can encounter situation where you want to make authenticated request to fetch some content etc. To do so, you need a token
How to obtain a token?#
Kitsu API documentation already cover this topic here
First you will need to make an account on kitsu website.
After making an acconut, you’ll need to make a post request to https://kitsu.io/api/oauth/token
Kitsu supports 3 grant types, but for now only Password is implemented
Making POST request#
To make a post request we can run this simple python script
import requests
url = "https://kitsu.io/api/oauth/token"
#Make sure to replace username and password with your credentials
data ={
"grant_type": 'password',
"username": '<username or email>',
"password": '<password>' #Must be RFC3986 encoded
}
response = requests.post(url, data=data)
print(response.text)
If the response was successful, this will print out
#From kitsu docs
{
access_token: 'abc123', #The token
created_at: 1518235801,
expires_in: 2591963, #Seconds until the access_token expires (30 days default)
refresh_token: '123abc', #Token used to get a new access_token it expires
scope: 'public',
token_type: 'bearer'
}
After obtaining a token#
Now that we got a token, we can pass it to askitsu.Client
and make
authenticated requests
import askitsu
client = askitsu.Client("abc123...")
Next: Simple examples