Oauth Callback

Handle OAuth callback: exchange code, find/create user, return JWT.

POST /cabinet/auth/oauth/{provider}/callback

Oauth Callback

cURL

curl --request POST \
  --url https://api.example.com/cabinet/auth/oauth/{provider}/callback \
  --header 'Content-Type: application/json' \
  --data '
{
  "code": "<string>",
  "state": "<string>",
  "device_id": "<string>",
  "campaign_slug": "<string>",
  "referral_code": "<string>"
}
'

200

{
  "access_token": "<string>",
  "refresh_token": "<string>",
  "expires_in": 123,
  "user": {
    "id": 123,
    "created_at": "2023-11-07T05:31:56Z",
    "telegram_id": 123,
    "username": "<string>",
    "first_name": "<string>",
    "last_name": "<string>",
    "email": "<string>",
    "email_verified": false,
    "balance_kopeks": 0,
    "balance_rubles": 0,
    "referral_code": "<string>",
    "language": "ru",
    "auth_type": "telegram"
  },
  "token_type": "bearer",
  "campaign_bonus": {
    "campaign_name": "<string>",
    "bonus_type": "<string>",
    "balance_kopeks": 0,
    "subscription_days": 123,
    "tariff_name": "<string>"
  }
}

Path Parameters

provider · enum<string> · required

Available options: google, yandex, discord, vk

Body

application/json

code · string · required

Authorization code from provider

Required string length: 1 - 2048

state · string · required

CSRF state token

Required string length: 1 - 128

device_id · string | null

Device ID from VK ID callback

Maximum string length: 256

campaign_slug · string | null

Campaign slug from web link

Required string length: 1 - 64

Pattern: ^[a-zA-Z0-9_-]+$

referral_code · string | null

Referral code of inviter

Maximum string length: 32

Pattern: ^[a-zA-Z0-9_-]+$

Response

200

application/json

Successful Response

Full authentication response with tokens and user.

access_token · string · required

refresh_token · string · required

expires_in · integer · required

user · UserResponse · object · required

User data response.

Show child attributes

token_type · string · default: bearer

campaign_bonus · CampaignBonusInfo · object

Info about campaign bonus applied during auth.

Show child attributes