사용자의 리소스 경로.
형식: users/{user_id}.
*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.
User
Roblox에 등록된 모든 사용자를 나타냅니다.
특성
사용자가 생성된 시점의 타임스탬프. 이 문자열은 Timestamp 형식으로 지정됩니다.
Roblox에서 사용자를 식별하는 고유 ID.
Roblox의 사용자에 대한 고유 사용자 이름.
사용자의 표시 이름.
자신에 대한 사용자 정의 정보.
사용자가 선택한 현재 로캘. IETF 언어 코드를 반환합니다.
사용자가 프리미엄 사용자인지 여부.
사용자가 VoIP 전화 번호나 정부 ID가 확인되는지 여부를 지정합니다. 확인에는 제한이 없지만, 비VoIP 전화 번호나 정부 ID가 포함됩니다.
이 데이터에 액세스하려면 다음 범위의 API 키/OAuth 토큰이 필요합니다: user.advanced:read.
사용자의 소셜 네트워크 프로필 및 가시성.
기본 URL
https://apis.roblox.comUser 리소스
{
"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
사용자 가져오기
GET /cloud/v2/users/{user_id}
사용자의 기본 및 고급 정보를 가져옵니다.
사용자의 공개 정보에 액세스하려면 추가 범위가 필요하지 않습니다.
사용자의 확인 상태에 액세스하려면 다음 범위가 필요합니다:
- 사용자.advanced:read
사용자의 소셜 계정 정보에 액세스하려면 다음 범위가 필요합니다:
- 사용자.social:read
사용자 ID.
응답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}'응답
{
"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
사용자 썸네일 생성
GET /cloud/v2/users/{user_id}:generateThumbnail
사용자의 아바타 썸네일에 대한 URL을 생성하고 반환합니다.
사용자 ID.
생성된 썸네일의 크기. 생성된 썸네일에는 size * size 차원이 있습니다.
현재 지원되는 값: 48, 50, 60, 75, 100, 110, 150, 180, 352, 420, 720 기본값은 420입니다.
생성된 썸네일의 형식을 지정합니다. 기본값은 PNG 입니다.
가능한 값:
| 값 | 설명 | | --- | --- | | FORMAT_UNSPECIFIED | 기본 사용자 썸네일 형식 -- png로 설정 | | PNG | 썸네일을 .png 형식으로 생성 | | JPEG | 썸네일을 .jpg 형식으로 생성 |. 가능한 값:
썸네일의 모양을 지정합니다. 기본값은 ROUND (원형)입니다.
가능한 값:
| 값 | 설명 | | --- | --- | | SHAPE_UNSPECIFIED | 기본 사용자 썸네일 모양 -- 원으로 설정 | | ROUND | 원형으로 썸네일을 생성합니다.| | 광장 | 사각형으로 썸네일 생성. |. 가능한 값:
응답응답imageUristring
비동기적 방식으로, 현재 작업 상태를 나타내는 '작업'을 반환합니다. 여기에는 투표를 진행하여 실제 응답과 적용 가능한 메타데이터를 얻을 수 있는 엔드포인트 경로가 포함됩니다. 자세한 정보는 장기 작업에 관한 설명서에서 확인하세요.
아래 섹션은 작업 완료 시 제공되는 응답 및 메타데이터 개체에 대한 설명입니다.
사용자 아바타 썸네일의 URL을 반환합니다.
생성된 썸네일의 URI.
없음
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}'