djoser.readthedocs.io not up-to-date

“Latest” documentation on djoser.readthedocs.io is not 1.3.0, but some different version. Specifically, SERIALIZERS.current_user is missing from the settings documentation.

Compare: Outdated documentation on readthedocs Should-be documentation on github (CTRL-F “current_user”)

[dekoza]

I’m on it. We needed to regain the access to readthedocs from previous dev.

[peterkmurphy]

I was able to migrate from 1.3.2 to 1.4.0 (and from rest_framework_jwt to rest_framework_simplejwt), but it wasn’t a pleasant couple of hours. My notes for the documentation, so as to save anyone else pain.

1. POST to /v0/jwt/create with username and password. Before, the server returns JSON with one key “token” match a value (the JWT). In 1.4.0, the server returns two keys. There’s “access”, and its value is the JWT; it’s basically a replacement for “token”. There’s also “refresh”, and its value is used for refreshing tokens.
2. In 1.3.2, the value for “token” can be used with POSTs to /v0/jwt/verify and /v0/jwt/refresh. In 1.4.0, the value for “access” is used for the verify URL (and for other places where you use JWT). But the value for “refresh” is used with /v0/jwt/refresh instead.
3. When you are using rest_framework_jwt, you pass HTTP headers like:

Authorization: JWT <token>

The rest_framework_simplejwt expects headers like:

Authorization: Bearer <token>

Does that mean a rewrite of the code using your API ? Not necessarily; put something like this in your settings.py file

SIMPLE_JWT = {
    "AUTH_HEADER_TYPES": ("Bearer", "JWT"),
} 

I hope this information is of use for the document writers. Cheers.