API Documentation

Laravel Telegram Mini App API Reference

GET /api/last_spin

Check if user can spin again (24-hour cooldown)

Response

{
    "can_spin": true|false
}

GET /api/tokens

Get user's token balance

Response

{
    "user": "string",
    "total_tokens": integer
}

POST /api/spin

Perform a spin and receive tokens

Request Body

{
    "token_received": integer
}

Response

{
    "message": "string",
    "total_tokens": integer
}

GET /api/leaderboard

Get leaderboard information

Response

{
    "current_user": {
        "id": integer,
        "username": "string",
        "first_name": "string",
        "tokens_amount": integer
    },
    "top_users": [
        {
            "id": integer,
            "first_name": "string",
            "amount": integer
        }
    ],
    "total_users": integer
}

GET /api/friends

Get list of invited friends

Response

[
    {
        "id": integer,
        "first_name": "string",
        "username": "string"
    }
]

GET /api/invite-code

Get user's invite code

Response

{
    "invite_code": "string"
}

POST /api/complete_task

Complete a task and receive rewards

Request Body

{
    "task": integer
}

Response

{
    "status": "string",
    "message": "string",
    "new_point": integer,
    "token_amount": integer
}

GET /api/complete_task

Get user's current task point

Response

{
    "point": integer
}