Retrieve | AISquare Studio

curl /api/v1/player/ \
     -H "Content-Type: application/json"

{
  "rank": 5,
  "user": {
    "id": 42,
    "username": "chessMaster99",
    "email": "chessmaster99@example.com",
    "first_time_login": false,
    "profile_picture": "https://cdn.aisquare.com/profiles/42/avatar.png",
    "full_name": "Alice Johnson",
    "theme": "dark-mode",
    "is_superuser": false,
    "is_staff": false,
    "is_active": true,
    "is_verified": true
  },
  "elo": 1520,
  "current_level": {
    "level": 7,
    "label": "Advanced Player",
    "xp_required": 4000,
    "emoji": "♟️",
    "icon": "https://cdn.aisquare.com/icons/levels/advanced.png",
    "description": "You have mastered many strategies and tactics."
  },
  "experience": 3450,
  "experience_level": 7
}

Response

rankintegerRead-only

userobject

Mixin to handle profile_picture serialization for WebSocket compatibility.

This mixin adds a SerializerMethodField for profile_picture that converts ImageFieldFile objects to URL strings, making them JSON serializable for WebSocket consumers.

The mixin intelligently handles profile pictures from IAMUserDetail by:

Accessing the related details queryset on the IAMUser model
Extracting the ImageFieldFile from the first detail record
Converting it to a URL string for JSON serialization

Usage:

1 class MyUserSerializer(ProfilePictureMixin, serializers.ModelSerializer):
2     class Meta:
3         model = User
4         fields = ['id', 'username', 'profile_picture', ...]

Note:

This mixin expects the model to have a details related manager
The related detail should have a profile_picture ImageField
Returns None if no profile picture is found or an error occurs

Mixin to handle profile_picture serialization for WebSocket compatibility. This mixin adds a SerializerMethodField for profile_picture that converts ImageFieldFile objects to URL strings, making them JSON serializable for WebSocket consumers. The mixin intelligently handles profile pictures from IAMUserDetail by: 1. Accessing the related `details` queryset on the IAMUser model 2. Extracting the ImageFieldFile from the first detail record 3. Converting it to a URL string for JSON serialization Usage: ```python class MyUserSerializer(ProfilePictureMixin, serializers.ModelSerializer): class Meta: model = User fields = ['id', 'username', 'profile_picture', ...] ``` Note: - This mixin expects the model to have a `details` related manager - The related detail should have a `profile_picture` ImageField - Returns None if no profile picture is found or an error occurs

elointegerRead-only

current_levelobject

Serializer for experience level information

experienceinteger-2147483648-2147483647

experience_levelinteger-2147483648-2147483647

Mixin to handle profile_picture serialization for WebSocket compatibility.

This mixin adds a SerializerMethodField for profile_picture that converts ImageFieldFile objects to URL strings, making them JSON serializable for WebSocket consumers.

The mixin intelligently handles profile pictures from IAMUserDetail by:

Accessing the related details queryset on the IAMUser model
Extracting the ImageFieldFile from the first detail record
Converting it to a URL string for JSON serialization

Usage:

1 class MyUserSerializer(ProfilePictureMixin, serializers.ModelSerializer):
2     class Meta:
3         model = User
4         fields = ['id', 'username', 'profile_picture', ...]

Note:

This mixin expects the model to have a details related manager
The related detail should have a profile_picture ImageField
Returns None if no profile picture is found or an error occurs

1	class MyUserSerializer(ProfilePictureMixin, serializers.ModelSerializer):
2	class Meta:
3	model = User
4	fields = ['id', 'username', 'profile_picture', ...]