*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.

User

Representa a cualquier usuario registrado de Roblox.

Atributos

pathstring

El camino de recursos del usuario.

Formato: users/{user_id}.

createTimestring
Solo salida

La marca de tiempo en la que se creó el usuario. Esta cadena está formateada como Timestamp.

idstring
Solo salida

ID único que identifica a un usuario en Roblox.

namestring

Nombre de usuario único para un usuario en Roblox.

displayNamestring

Nombre de visualización para el usuario.

aboutstring

Información definida por el usuario sobre sí mismos.

localestring

Local actual seleccionado por el usuario. Devuelve el código de idioma de IETF.

premiumboolean
Solo salida

Si el usuario es un usuario premium.

idVerifiedboolean
Solo salida

Specifica si el usuario está verificado de identidad. La verificación incluye, pero no se limita a los números de teléfono no VoIP o las identificaciones gubernamentales.

Para acceder a estos datos, necesitas una clave de API / un token de OAuth con el siguiente alcance: user.advanced:read.

socialNetworkProfilesobject

Perfiles de red social y visibilidad del usuario.

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

Obtener usuario
Beta

GET /cloud/v2/users/{user_id}

Obtiene la información básica y avanzada de un usuario.

Para acceder a la información pública de un usuario, no se requieren ámbitos adicionales.

Para acceder al estado de verificación de un usuario, necesitas los siguientes alcances:

  • usuario.advanced:leer

Para acceder a la información de la cuenta social de un usuario, necesitas los siguientes alcances:

  • user.social:leer
SolicitudParámetros de ruta
user_idstring
Obligatorio

La identificación del usuario.

RespuestaUser
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}'
Respuesta
{

  "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

Generar imagen de usuario
Beta

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

Genera y devuelve la URL para la miniatura del avatar del usuario.

SolicitudParámetros de ruta
user_idstring
Obligatorio

La identificación del usuario.

Parámetros de consulta
sizenumber

Tamaño de la miniatura generada. La miniatura generada tendrá size * size dimensión.

Valores actualmente admitidos: 48, 50, 60, 75, 100, 110, 150, 180, 352, 420, 720 Por defecto es 420.

formatEnum<string>

Especifique el formato de la miniatura generada. Por defecto es PNG .

Posibles valores:

| Valor | Descripción | | --- | --- | | FORMAT_UNSPECIFIED | Formato de imagen predeterminado del usuario -- establecido a png | | PNG | Generar miniatura en formato .png | | JPEG | Generar miniatura en formato .jpg |. Valores posibles:

shapeEnum<string>

Especifique la forma de la miniatura. Por defecto es ROUND (circular).

Posibles valores:

| Valor | Descripción | | --- | --- | | SHAPE_UNSPECIFIED | Forma predeterminada de la imagen del usuario -- establecida a redonda | | RONDA | Generar una miniatura como un círculo.| | CUADRADO | Generar miniatura como un rectángulo. |. Valores posibles:

Respuesta

Este método es asíncrono y devuelve una Operación, que representa el estado actual de la operación. Contiene una ruta final que puede sondear para obtener la respuesta real y los metadatos aplicables. Ve la documentation en operaciones de larga duración para más información.

Las siguientes secciones describen la respuesta y los objetos metadatos que se proporcionan cuando una operación termina.

Respuesta

Devuelve la URL para la miniatura del avatar del usuario.

imageUristring

URI para la miniatura generada.

Metadatos

Nada

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