*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

User

Rappresenta qualsiasi utente registrato di Roblox.

Attributi

pathstring

Il percorso risorsa dell'utente.

Formato: users/{user_id}.

createTimestring
Solo output

L'timestamp in cui l'utente è stato creato. Questa stringa è formattata come Timestamp.

idstring
Solo output

ID univoco che identifica un utente in Roblox.

namestring

Nome utente univoco per un utente in Roblox.

displayNamestring

Nome da mostrare per l'utente.

aboutstring

Informazioni definite dall'utente su se stesso.

localestring

Località attuale selezionata dall'utente. Restituisce il codice linguistico IETF.

premiumboolean
Solo output

Se l'utente è un utente premium.

idVerifiedboolean
Solo output

Specifica se l'utente è verificato nell'identità. La verifica include, ma non è limitata a, numeri di telefono non VoIP o ID governativi.

Per accedere a questi dati, hai bisogno di una chiave API/token OAuth con il seguente ambito: user.advanced:read.

socialNetworkProfilesobject

Profili e visibilità del social network dell'utente.

URL di base
https://apis.roblox.com
Risorsa 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

Ottieni utente
Beta

GET /cloud/v2/users/{user_id}

Ottiene le informazioni di base e avanzate di un utente.

Per accedere alle informazioni pubbliche di un utente non sono richiesti ulteriori ambiti.

Per accedere allo stato di verifica di un utente, hai bisogno dei seguenti scope:

  • utente.advanced:read

Per accedere alle informazioni sul social account di un utente hai bisogno dei seguenti scope:

  • user.social:leggi
RichiestaParametri percorso
user_idstring
Necessario

L'ID utente.

RispostaUser
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}'
Risposta
{

  "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

Genera una miniatura dell'utente
Beta

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

Genera e restituisce l'URL per la miniatura dell'avatar dell'utente.

RichiestaParametri percorso
user_idstring
Necessario

L'ID utente.

Parametri query
sizenumber

Dimensione della miniatura generata. La miniatura generata avrà size * size dimensione.

Valori attualmente supportati: 48, 50, 60, 75, 100, 110, 150, 180, 352, 420, 720 Il predefinito è 420.

formatEnum<string>

Specifica il formato della miniatura generata. Il predefinito è PNG .

Valori possibili:

| Valore | Descrizione | | --- | --- | | FORMAT_UNSPECIFIED | Formato di immagine predefinito dell'utente -- impostato su png | | PNG | Genera l'immagine in formato .png | | JPEG | Genera l'immagine in formato .jpg |. Valori possibili:

shapeEnum<string>

Specifica la forma della miniatura. Il predefinito è ROUND (circolare).

Valori possibili:

| Valore | Descrizione | | --- | --- | | SHAPE_UNSPECIFIED | Forma predefinita dell'immagine dell'utente - impostata a rotondo | | ROUND | Genera l'immagine come un cerchio.| | SQUARE | Genera una miniatura come rettangolo. |. Valori possibili:

Risposta

Questo metodo è asincrono e restituisce un'"operazione", che rappresenta lo stato corrente della stessa. Contiene un percorso endpoint che è possibile sondare per ottenere la risposta reale e i metadati applicabili. Per ulteriori informazioni, consulta la documentazione sulle operazioni di lunga durata.

Le sezioni seguenti descrivono gli oggetti di risposta e metadati forniti al completamento di un'operazione.

Risposta

Restituisce l'URL per la miniatura dell'avatar dell'utente.

imageUristring

URI per la miniatura generata.

Metadati

Nessuno

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