*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.

User

Reprezentuje każdego zarejestrowanego użytkownika Roblox.

Atrybuty

pathstring

Ścieżka zasobów użytkownika.

Format: users/{user_id}.

createTimestring
Tylko dane wyjściowe

Data i czas utworzenia użytkownika. Ten ciąg jest sformatowany jako Timestamp.

idstring
Tylko dane wyjściowe

Unikalny identyfikator, który identyfikuje użytkownika w Roblox.

namestring

Unikalna nazwa użytkownika dla użytkownika w Roblox.

displayNamestring

Nazwa wyświetlana dla użytkownika.

aboutstring

Informacje zdefiniowane przez użytkownika o sobie.

localestring

Obecny lokalny wybrany przez użytkownika. Powraca kod języka IETF.

premiumboolean
Tylko dane wyjściowe

Czy użytkownik jest użytkownikiem premium.

idVerifiedboolean
Tylko dane wyjściowe

Określa, czy użytkownik jest zweryfikowany. Weryfikacja obejmuje, ale nie ogranicza się do numerów telefonów nie-VoIP lub identyfikatorów rządowych.

Aby uzyskać dostęp do tych danych, potrzebujesz klucza API / tokenu OAuth z następującym zakresem: user.advanced:read.

socialNetworkProfilesobject

Profile sieci społecznościowych użytkownika i jego widoczność.

Podstawowy adres URL
https://apis.roblox.com
Zasób User
{

  "path": "users/123",

  "createTime": "2023-07-05T12:34:56Z",

  "id": "123456",

  "name": "exampleUser",

  "displayName": "userDefinedName",

  "about": "Example User's bio",

  "locale": "en-US",

  "premium": true,

  "idVerified": true,

  "socialNetworkProfiles": {

    "facebook": "string",

    "twitter": "string",

    "youtube": "string",

    "twitch": "string",

    "guilded": "string",

    "visibility": "SOCIAL_NETWORK_VISIBILITY_UNSPECIFIED"

  }

}

User

Zdobądź użytkownika
Beta

GET /cloud/v2/users/{user_id}

Zdobywa podstawowe i zaawansowane informacje użytkownika.

Aby uzyskać dostęp do publicznych informacji użytkownika, nie są wymagane dodatkowe zakresy.

Aby uzyskać status weryfikacji użytkownika, potrzebujesz następujących zakresów:

  • user.advanced:czytaj

Aby uzyskać informacje o kontach społecznościowych użytkownika, potrzebujesz następujących zakresów:

  • user.social:czytaj
ŻądanieParametry ścieżki
user_idstring
Wymagane

ID użytkownika.

Odpowiedź:User
GET /cloud/v2/users/{user_id}
curl -L -X GET 'https://apis.roblox.com/cloud/v2/users/{user_id}' \

  -H 'x-api-key: {your-api-key}'
Odpowiedź:
{

  "path": "users/123",

  "createTime": "2023-07-05T12:34:56Z",

  "id": "123456",

  "name": "exampleUser",

  "displayName": "userDefinedName",

  "about": "Example User's bio",

  "locale": "en-US",

  "premium": true,

  "idVerified": true,

  "socialNetworkProfiles": {

    "facebook": "string",

    "twitter": "string",

    "youtube": "string",

    "twitch": "string",

    "guilded": "string",

    "visibility": "SOCIAL_NETWORK_VISIBILITY_UNSPECIFIED"

  }

}

User

Generuj miniaturkę użytkownika
Beta

GET /cloud/v2/users/{user_id}:generateThumbnail

Generuje i zwraca URL miniaturki awatara użytkownika.

ŻądanieParametry ścieżki
user_idstring
Wymagane

ID użytkownika.

Parametry zapytania
sizenumber

Rozmiar wygenerowanego miniaturki. Wygenerowana miniaturka będzie miała wymiar size * size.

Obecnie wspierane wartości: 48, 50, 60, 75, 100, 110, 150, 180, 352, 420, 720 Domyślna wartość to 420.

formatEnum<string>

Określ format wygenerowanego miniaturki. Domyślnie jest to PNG .

Możliwe wartości:

| Wartość | Opis | | --- | --- | | FORMAT_UNSPECIFIED | Domyślny format zdjęcia użytkownika - ustaw na png | | PNG | Generuj zdjęcie w formacie .png | | JPEG | Generuj zdjęcie w formacie .jpg |. Możliwe wartości:

shapeEnum<string>

Określ kształt miniaturki. Domyślnie jest to ROUND (okrągły).

Możliwe wartości:

| Wartość | Opis | | --- | --- | | SHAPE_UNSPECIFIED | Domyślny kształt zdjęcia użytkownika - ustaw na okrągły | | OKRĄG | Generuj miniaturkę jako okrąg || | SQUARE | Wygeneruj miniaturę jako prostokąt. |. Możliwe wartości:

Odpowiedź:

Jest to metoda asynchroniczna, która zwraca deskryptor „Operation”, odpowiadający bieżącemu stanowi operacji. Zawiera punkt końcowy, który można wybrać przy użyciu funkcji poll, aby otrzymać rzeczywistą odpowiedź i nadające się do użycia metadane. Więcej informacji na temat operacji długotrwałych zawiera dokumentacja.

W poniższych sekcjach opisano odpowiedzi i obiekty w postaci metadanych, które zostają podane po ukończeniu operacji.

Odpowiedź:

Zwraca URL dla miniaturki awatara użytkownika.

imageUristring

URI dla wygenerowanego miniaturki.

Metadane

Brak

GET /cloud/v2/users/{user_id}:generateThumbnail
curl -L -X GET 'https://apis.roblox.com/cloud/v2/users/{user_id}:generateThumbnail?size={integer}&format={string}&shape={string}' \

  -H 'x-api-key: {your-api-key}'