Login and/or Get Current User Info

This endpoint does the following two operations:

Checks if you are already logged in by looking for a valid auth cookie. If you are have a valid auth cookie then no additional auth-related actions are taken. If you are not logged in then it will log you in with the Authorization header and set the auth cookie. The auth cookie will only be sent once.

If logged in, this function will also return the CurrentUser object containing detailed information about the currently logged in user.

The auth string after Authorization: Basic {string} is a base64-encoded string of the username and password, both individually url-encoded, and then joined with a colon.

base64(urlencode(username):urlencode(password))

WARNING: Session Limit: Each authentication with login credentials counts as a separate session, out of which you have a limited amount. Make sure to save and reuse the auth cookie if you are often restarting the program. The provided API libraries automatically save cookies during runtime, but does not persist during restart. While it can be fine to use username/password during development, expect in production to very fast run into the rate-limit and be temporarily blocked from making new sessions until older ones expire. The exact number of simultaneous sessions is unknown/undisclosed.

返回响应

🟢200成功

application/json

Headers

Bodyapplication/json

示例

{
    "ageVerificationStatus": "hidden",
    "ageVerified": true,
    "currentAvatar": "avtr_912d66a4-4714-43b8-8407-7de2cafbf55b",
    "currentAvatarImageUrl": "https://api.vrchat.cloud/api/1/file/file_ae46d521-7281-4b38-b365-804b32a1d6a7/1/file",
    "currentAvatarThumbnailImageUrl": "https://api.vrchat.cloud/api/1/image/file_aae83ed9-d42d-4d72-9f4b-9f1e41ed17e1/1/256",
    "developerType": "none",
    "fallbackAvatar": "avtr_912d66a4-4714-43b8-8407-7de2cafbf55b",
    "homeLocation": "wrld_ba913a96-fac4-4048-a062-9aa5db092812",
    "id": "usr_c1644b5b-3ca4-45b4-97c6-a2a0de70d469",
    "last_platform": "standalonewindows",
    "presence": {
        "id": "usr_c1644b5b-3ca4-45b4-97c6-a2a0de70d469",
        "travelingToWorld": "wrld_ba913a96-fac4-4048-a062-9aa5db092812",
        "world": "wrld_ba913a96-fac4-4048-a062-9aa5db092812",
        "avatarThumbnail": "string",
        "currentAvatarTags": "string",
        "displayName": "string",
        "groups": [
            "grp_71a7ff59-112c-4e78-a990-c7cc650776e5"
        ],
        "instance": "string",
        "instanceType": "string",
        "isRejoining": "string",
        "platform": "string",
        "profilePicOverride": "string",
        "status": "string",
        "travelingToInstance": "string",
        "userIcon": "string"
    },
    "state": "offline",
    "status": "offline",
    "acceptedTOSVersion": 7,
    "acceptedPrivacyVersion": 0,
    "accountDeletionDate": "2019-08-24",
    "accountDeletionLog": [
        {
            "message": "Deletion requested",
            "deletionScheduled": "2019-08-24T14:15:22.123Z",
            "dateTime": "2019-08-24T14:15:22.123Z"
        }
    ],
    "activeFriends": [
        "usr_c1644b5b-3ca4-45b4-97c6-a2a0de70d469"
    ],
    "allowAvatarCopying": true,
    "badges": [
        {
            "badgeId": "bdg_a60e514a-8cb7-4702-8f24-2786992be1a8",
            "assignedAt": "2019-08-24T14:15:22.123Z",
            "badgeDescription": "string",
            "badgeImageUrl": "string",
            "badgeName": "string",
            "hidden": true,
            "showcased": true,
            "updatedAt": "2019-08-24T14:15:22.123Z"
        }
    ],
    "bio": "string",
    "currentAvatarAssetUrl": "string",
    "currentAvatarTags": [
        "string"
    ],
    "date_joined": "2019-08-24",
    "displayName": "string",
    "emailVerified": true,
    "friendKey": "string",
    "friends": [
        "usr_c1644b5b-3ca4-45b4-97c6-a2a0de70d469"
    ],
    "hasBirthday": true,
    "hideContentFilterSettings": true,
    "userLanguage": "string",
    "userLanguageCode": "string",
    "hasEmail": true,
    "hasLoggedInFromClient": true,
    "hasPendingEmail": true,
    "isAdult": true,
    "isBoopingEnabled": true,
    "isFriend": false,
    "last_activity": "2019-08-24T14:15:22.123Z",
    "last_login": "2019-08-24T14:15:22.123Z",
    "last_mobile": "2019-08-24T14:15:22.123Z",
    "obfuscatedEmail": "string",
    "obfuscatedPendingEmail": "string",
    "oculusId": "string",
    "googleId": "string",
    "googleDetails": {},
    "picoId": "string",
    "viveId": "string",
    "offlineFriends": [
        "usr_c1644b5b-3ca4-45b4-97c6-a2a0de70d469"
    ],
    "onlineFriends": [
        "usr_c1644b5b-3ca4-45b4-97c6-a2a0de70d469"
    ],
    "pastDisplayNames": [
        {
            "displayName": "string",
            "updated_at": "2019-08-24T14:15:22.123Z"
        }
    ],
    "profilePicOverride": "string",
    "profilePicOverrideThumbnail": "string",
    "pronouns": "string",
    "queuedInstance": "string",
    "receiveMobileInvitations": true,
    "statusDescription": "string",
    "statusFirstTime": true,
    "steamDetails": {},
    "steamId": "string",
    "tags": [
        "string"
    ],
    "twoFactorAuthEnabled": true,
    "twoFactorAuthEnabledDate": "2019-08-24T14:15:22.123Z",
    "unsubscribe": true,
    "updated_at": "2019-08-24T14:15:22.123Z",
    "userIcon": "string",
    "username": "string",
    "bioLinks": [
        "string"
    ],
    "friendGroupNames": [
        "string"
    ],
    "statusHistory": [
        "string"
    ],
    "platform_history": [
        {
            "isMobile": true,
            "platform": "string",
            "recorded": "2019-08-24T14:15:22.123Z"
        }
    ]
}

🟠401没有权限

Login and/or Get Current User Info

请求参数

请求示例代码

返回响应