자산 API

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

Assets

https://apis.roblox.com/assets

자산 버전 목록

GET /assets/v1/assets/{assetId}/versions

매개 변수

assetId string
Path
필수
maxPageSize number
pageToken string

요청

List Asset Versions
curl --location 'https://apis.roblox.com/assets/v1/assets/{assetid}/versions?pageToken=&maxPageSize=' \

--header 'x-api-key: {apiKey}'

응답

필요한 권한

  • 읽기
  • asset:read

한도

각 API 키별: IP 주소당 60초마다 60 요청

롤백 자산 버전

POST /assets/v1/assets/{assetId}/versions:rollback

매개 변수

assetId string
Path
필수
assetVersion string
FormData
필수

요청

Rollback Asset Versions
curl --location 'https://apis.roblox.com/assets/v1/assets/{assetid}/versions:rollback' \

--header 'x-api-key: {apiKey}' \

--header 'Content-Type: application/json' \

--data '{\"assetVersion\":\"assets/{assetId}/versions/{versionNumber}\"}'

응답

필요한 권한

  • 읽기
  • 쓰기
  • asset:read
  • asset:write

한도

각 API 키별: IP 주소당 60초마다 60 요청

자산 얻기

GET /v1/assets

매개 변수

assetId
Path
필수
readMask string

요청

Get Asset without readMask
curl --location --request GET 'https://apis.roblox.com/assets/v1/assets/{assetId}' \

--header 'x-api-key: {apiKey}'
Get Asset with readMask
curl --location --request GET 'https://apis.roblox.com/assets/v1/assets/{assetId}?readMask={read_mask}' \

--header 'x-api-key: {apiKey}'

응답

필요한 권한

  • 읽기
  • asset:read

한도

각 API 키별: IP 주소당 60초마다 60 요청

자산 생성

POST /v1/assets

매개 변수

request
FormData
필수
fileContent string
FormData
필수

요청

Create Asset
curl --location --request POST 'https://apis.roblox.com/assets/v1/assets' \

--header 'x-api-key: {apiKey}' \

--form 'request="{ 

  \"assetType\": \"Model\",  

  \"displayName\": \"Name\", 

  \"description\": \"This is a description\", 

  \"creationContext\": { 

    \"creator\": { 

      \"userId\": \"${userId}\" 

    } 

  } 

}"' \

--form 'fileContent=@"/filepath/model.fbx";type=model/fbx'

응답

200 - OK
생성 상태를 확인하기 위한 작업 ID를 반환합니다.
반환: object
done boolean
error object
metadata object
path string
response object

필요한 권한

  • 읽기
  • 쓰기
  • asset:read
  • asset:write

한도

각 API 키별: IP 주소당 60초마다 60 요청

자산 업데이트

PATCH /v1/assets/{assetId}

매개 변수

request
FormData
필수
fileContent string
FormData
updateMask string

요청

Update Content Only and Create a New Version
curl --location --request PATCH 'https://apis.roblox.com/assets/v1/assets/{assetId}' \

--header 'x-api-key: {apiKey}' \

--form 'request="{\"assetId\": {assetId} }"' \

--form 'fileContent="@\"{file-path}\""'
Update Content and Metadata
curl --location --request PATCH 'https://apis.roblox.com/assets/v1/assets/{assetId}?updateMask=description%2CdisplayName' \

--header 'x-api-key: {apiKey}' \

--form 'request="{

    \"assetType\": \"{assetType}\",

    \"assetId\": {assetId},

    \"displayName\": \"{new display name}\",

    \"description\": \"{new description}\",    

    \"creationContext\": { 

        \"creator\": {

            \"userId\": {userId}

        },

        \"expectedPrice\":{expectedPrice}

    },

}"' \

--form 'fileContent=@\"{file-path}\"'
Update a List of Previews
curl --location --request PATCH 'https://apis.roblox.com/assets/v1/assets/{assetId}?updateMask=previews' \

--header 'x-api-key: {apiKey}' \

--form 'request="{\"assetId\": \"{assetId}\", \"previews\": [{\"asset\": \"assets/123\", \"altText\": \"Your alt text.\"}]}"'
Update Social Links

응답

200 - OK
업데이트 상태를 확인하는 데 필요한 작업 ID 반환 / 업데이트된 메타데이터 필드를 반환합니다.
반환: object
application/json
{\"previews\": [\n    {\"asset\": \"assets/123\", \"altText\": \"preview 1\"},\n    {\"asset\": \"assets/456\", \"altText\": \"preview 2\"}\n]}
done boolean
error object
metadata object
path string
response object

필요한 권한

  • 읽기
  • 쓰기
  • asset:read
  • asset:write

한도

각 API 키별: IP 주소당 60초마다 60 요청

자산 버전 받기

GET /v1/assets/{assetId}/versions/{versionNumber}

매개 변수

assetId string
Path
필수
versionNumber string
Path
필수

요청

Get Asset Version
curl --location 'https://apis.roblox.com/assets/v1/assets/{assetId}/versions/{versionNumber}' \

--header 'x-api-key: {apiKey}'

응답

필요한 권한

  • 읽기
  • asset:read

한도

각 API 키별: IP 주소당 60초마다 60 요청

작업 얻기

GET /v1/operations/{operationId}

요청

Get Operation
curl --location 'https://apis.roblox.com/assets/v1/operations/{operationId}' \

--header 'x-api-key: {apiKey}'

응답

200 - OK
반환: object
done boolean
error object
metadata object
path string
response object

필요한 권한

  • 읽기
  • asset:read

한도

각 API 키별: IP 주소당 60초마다 60 요청

개체

다음 개체는 수락되거나 반환되는 페이로드를 설명합니다. 이러한 개체가 사용되는 시기에 대한 자세한 정보는 각 개별 끝점을 참고하세요.

Any

특성

@type string

Asset

특성

assetId number
assetType string
creationContext object
description string
displayName string
icon string
moderationResult object
path string
previews array<object>
revisionCreateTime string
revisionId string
socialLink object

CreationContext

특성

creator object
필수
expectedPrice number

Creator

특성

groupId number
userId number

ModerationResult

특성

moderationState string

Operation

특성

done boolean
error object
metadata object
path string
response object

Preview

특성

altText string
asset string

특성

title string
uri string

Status

특성

code number
details array<object>
message string