*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.

User

Vertreibt jeden registrierten Benutzer von Roblox.

Attribute

pathstring

Der Ressourcenpfad des Benutzers.

Format: users/{user_id}.

createTimestring
Nur Ausgabe

Der Zeitpunkt, zu dem der Benutzer erstellt wurde. Dieser String ist als Zeitstempel formatiert.

idstring
Nur Ausgabe

Einzigartige ID, die einen Benutzer in Roblox identifiziert.

namestring

Einzigartiger Benutzername für einen Benutzer in Roblox.

displayNamestring

Anzeigename für den Benutzer.

aboutstring

Benutzerdefinierte Informationen über sich selbst.

localestring

Derzeitige lokale Auswahl des Benutzers. Gibt den IETF-Sprachcode zurück.

premiumboolean
Nur Ausgabe

Ob der Benutzer ein Premium-Benutzer ist.

idVerifiedboolean
Nur Ausgabe

Gibt an, ob der Benutzer verifiziert ist. Die Verifizierung umfasst, ist aber nicht beschränkt auf, Nicht-VoIP-Telefonnummern oder Regierungs-IDs.

Um auf diese Daten zuzugreifen, benötigen Sie einen API-Schlüssel/OAuth-Token mit dem folgenden Umfang: user.advanced:read.

socialNetworkProfilesobject

Soziale Netzwerkprofile und Sichtbarkeit des Benutzers.

Basis-URL
https://apis.roblox.com
Die User-Ressource
{

  "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

Benutzer erhalten
Beta

GET /cloud/v2/users/{user_id}

Holen Sie sich die grundlegenden und erweiterten Informationen eines Benutzers.

Um die öffentlichen Informationen eines Benutzers abzurufen, sind keine zusätzlichen Bereiche erforderlich.

Um den Überprüfungsstatus eines Benutzers zu erhalten, benötigen Sie die folgenden Bereiche:

  • user.advanced:lesen

Um die sozialen Kontodaten eines Benutzers zuzugreifen, benötigen Sie die folgenden Bereiche:

  • user.social:lesen
AnfragePfadparameter
user_idstring
Erforderlich

Die Benutzer-ID.

RückmeldungUser
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}'
Rückmeldung
{

  "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

Benutzerbild generieren
Beta

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

Erzeugt und gibt die URL für die Avatarminiaturansicht des Benutzers zurück.

AnfragePfadparameter
user_idstring
Erforderlich

Die Benutzer-ID.

Anfrageparameter
sizenumber

Größe der generierten Miniaturansicht. Die generierte Miniaturansicht wird size * size Dimension haben.

Derzeit unterstützte Werte: 48, 50, 60, 75, 100, 110, 150, 180, 352, 420, 720 Standard ist 420.

formatEnum<string>

Geben Sie das Format der generierten Miniaturansicht an. Standard ist PNG .

Mögliche Werte:

| Wert | Beschreibung | | --- | --- | | FORMAT_UNSPEZIFIZIERT | Standard-Benutzerbildformat -- auf png gesetzt | | PNG | Generieren von Thumbnails im .png | | JPEG | Generieren von Thumbnails im .jpg |. Mögliche Werte:

shapeEnum<string>

Geben Sie die Form der Miniatur an. Standard ist ROUND (kreisförmig).

Mögliche Werte:

| Wert | Beschreibung | | --- | --- | | SHAPE_UNSPECIFIED | Standard-Benutzerbildform -- auf Runde festgelegt | | RUNDE | Generiere ein Thumbnail als Kreis.| | SQUARE | Erzeuge eine Miniatur als Rechteck. |. Mögliche Werte:

Rückmeldung

Diese Methode ist asynchron und gibt eine Operation zurück, die den aktuellen Status der Operation darstellt. Sie enthält einen Endpunktpfad, den du abfragen kannst, um die tatsächliche Antwort und die entsprechenden Metadaten zu erhalten. Weitere Informationen findest du in der Dokumentation.

Die folgenden Abschnitte beschreiben die Antwort- und Metadatenobjekte, die bereitgestellt werden, wenn eine Operation abgeschlossen ist.

Rückmeldung

Gibt die URL für die Avatarminiaturansicht des Benutzers zurück.

imageUristring

URI für die generierte Miniaturansicht.

Metadaten

Keine

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}'