클라우드

주문형 데이터 저장소(베타)

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

이 페이지에는 주문된 데이터 저장소와 작업하는 방법에 대한 참조 문서가 포함되어 있습니다. 자세한 내용은 API 사용 가이드 및 데이터 저장소 사용 가이드를 참조하십시오.

OrderedDataStores

https://apis.roblox.com/ordered-data-stores

목록

GET /v1/universes/{universeId}/orderedDataStores/{orderedDataStore}/scopes/{scope}/entries

주문된 데이터 상점항목 목록을 반환합니다.

매개 변수

universeId string

액세스하려는 주문형 데이터 저장소의 경험의 식별자. 참조 크리에이터 대시보드에서 복사하는 방법에 대해 유니버스 ID를 참조하십시오.

Path
필수
orderedDataStore string

대상 주문 데이터 상점이름입니다.

Path
필수
scope string

데이터 저장소 범위의 이름입니다. 보세요 범위.

Path
필수
max_page_size number

반환할 항목의 최대 개수입니다. 서비스는 이 값보다 작은 값을 반환할 수 있습니다. 기본 값은 10 입니다. 최대 값은 100 입니다. 100보다 큰 입력은 100 로 강제됩니다.

page_token string

이전 List 호출에서 받은 페이지 토큰. 이 페이지를 검색하려면 이 페이지 토큰을 제공하십시오. 지불 시 다른 모든 매개 변수는 List에 일치해야 합니다.

order_by string

열거 방향입니다. 기본적으로 순서는 오름차순입니다. 내림차순에 대해 desc 접두사를 입력합니다.

filter string

반환할 항목의 품질 값 범위. 자세한 내용은 필터를 참조하십시오.

요청

curl

curl --location 'https://apis.roblox.com/ordered-data-stores/v1/universes/<universeId>/orderedDataStores/<orderedDataStore>/scopes/<scope>/entries' \
--header 'x-api-key: <insert-api-key>'

응답

200 - OK
확인
반환: object
entries array<object>

지정된 범위의 항목.

nextPageToken string

다음 페이지를 검색하려면 page_token 으로 보낼 수 있는 토큰입니다. 이 필드를 생략하면 다음 페이지가 없습니다.

생성

POST /v1/universes/{universeId}/orderedDataStores/{orderedDataStore}/scopes/{scope}/entries

지정된 콘텐츠 값으로 새로운 항목을 생성합니다.

매개 변수

universeId string

액세스하려는 주문형 데이터 저장소의 경험의 식별자. 참조 크리에이터 대시보드에서 복사하는 방법에 대해 유니버스 ID를 참조하십시오.

Path
필수
orderedDataStore string

주문된 데이터 상점이름입니다.

Path
필수
scope string

데이터 저장소 범위의 이름입니다. 보세요 범위.

Path
필수
id string

항목의 이름입니다.

필수
CreateEntryRequest

지정된 값으로 새로운 항목을 생성합니다.

Body
필수

요청

curl

curl --location 'https://apis.roblox.com/ordered-data-stores/v1/universes/<universeId>/orderedDataStores/<orderedDataStore>/scopes/<scope>/entries?id=<id>' \
--header 'x-api-key: <insert-api-key>' \
--header 'Content-Type: application/json' \
--data '{
"value": <long>
}'

응답

200 - OK
확인
반환: object
id string

항목의 이름

path string

요청의 리소스 경로.

value number

값입니다.

가져다 가기

GET /v1/universes/{universeId}/orderedDataStores/{orderedDataStore}/scopes/{scope}/entries/{entry}

지정된 항목을 가져와 반환합니다.

매개 변수

universeId string

액세스하려는 주문형 데이터 저장소의 경험의 식별자. 참조 크리에이터 대시보드에서 복사하는 방법에 대해 유니버스 ID를 참조하십시오.

Path
필수
orderedDataStore string

주문된 데이터 상점이름입니다.

Path
필수
scope string

데이터 저장소 범위의 이름입니다. 보세요 범위.

Path
필수
entry string

입력 ID.

Path
필수

요청

curl

curl --location 'https://apis.roblox.com/ordered-data-stores/v1/universes/<universeId>/orderedDataStores/<orderedDataStore>/scopes/<scope>/entries/<entry>' \
--header 'x-api-key: <insert-api-key>'

응답

200 - OK
확인
반환: object
id string

항목의 이름

path string

요청의 리소스 경로.

value number

값입니다.

삭제

DELETE /v1/universes/{universeId}/orderedDataStores/{orderedDataStore}/scopes/{scope}/entries/{entry}

지정된 항목을 삭제합니다.

매개 변수

universeId string

액세스하려는 주문형 데이터 저장소의 경험의 식별자. 참조 크리에이터 대시보드에서 복사하는 방법에 대해 유니버스 ID를 참조하십시오.

Path
필수
orderedDataStore string

주문된 데이터 상점이름입니다.

Path
필수
scope string

데이터 저장소 범위의 이름입니다. 보세요 범위.

Path
필수
entry string

입력 ID.

Path
필수

요청

curl

curl --location --request DELETE 'https://apis.roblox.com/ordered-data-stores/v1/universes/<universeId>/orderedDataStores/<orderedDataStore>/scopes/<scope>/entries/<entry>' \
--header 'x-api-key: <insert-api-key>'

응답

업데이트

PATCH /v1/universes/{universeId}/orderedDataStores/{orderedDataStore}/scopes/{scope}/entries/{entry}

입력 값을 업데이트하고 업데이트된 입력을 반환합니다.

매개 변수

universeIdId string

액세스하려는 주문형 데이터 저장소의 경험의 식별자. 참조 크리에이터 대시보드에서 복사하는 방법에 대해 유니버스 ID를 참조하십시오.

Path
필수
orderedDataStore string

주문된 데이터 상점이름입니다.

Path
필수
scope string

데이터 저장소 범위의 이름입니다. 보세요 범위.

Path
필수
entry string

입력 ID.

Path
필수
UpdateEntryRequest

새 값으로 제공된 항목을 업데이트합니다.

Body
필수
allow_missing boolean

입력이 없는 경우 입력을 허용하도록 하는 플래그입니다. 자세한 내용은 허용 누락된 플래그를 참조하십시오.

요청

curl

curl --location --request PATCH 'https://apis.roblox.com/ordered-data-stores/v1/universes/<universeId>/orderedDataStores/<orderedDataStore>/scopes/<scope>/entries/<entry>' \
--header 'x-api-key: <insert-api-key>' \
--header 'Content-Type: application/json' \
--data '{
"value": <long>
}'

응답

200 - OK
확인
반환: object
id string

항목의 이름

path string

요청의 리소스 경로.

value number

값입니다.

증가량

POST /v1/universes/{universeId}/orderedDataStores/{orderedDataStore}/scopes/{scope}/entries/{entry}:increment

지정된 값으로 키의 값을 증가하고 업데이트된 항목을 반환합니다.

알려진 문제: 입력 값이 유효한 범위를 초과하면 백엔드에서 지속될 수 있습니다. 반환된 값은 유효한 범위에 맞춥니다.

매개 변수

universeId string

액세스하려는 주문형 데이터 저장소의 경험의 식별자. 참조 크리에이터 대시보드에서 복사하는 방법에 대해 유니버스 ID를 참조하십시오.

Path
필수
orderedDataStore string

주문된 데이터 상점이름입니다.

Path
필수
scope string

데이터 저장소 범위의 이름입니다. 보세요 범위.

Path
필수
entry string

입력 ID.

Path
필수
incrementEntryRequest

입력 값을 증가시킵니다.

Body
필수

요청

curl

curl --location 'https://apis.roblox.com/ordered-data-stores/v1/universes/<universeId>/orderedDataStores/<orderedDataStore>/scopes/<scope>/entries/<entry>:increment' \
--header 'x-api-key: <insert-api-key>' \
--header 'Content-Type: application/json' \
--data '{
"amount": <long>
}'

응답

200 - OK
확인
반환: object
id string

항목의 이름

path string

요청의 리소스 경로.

value number

값입니다.

개체

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

CreateEntryRequest

지정된 값으로 새로운 항목을 생성합니다.

특성

value number

새 항목을 설정하는 값입니다. 입력 값이 int64의 최대 값을 초과하면 9,223,372,036,854,775,807, 요청이 400 잘못된 요청 오류로 실패합니다.

Entry

입력을 나타냅니다.

특성

id string

항목의 이름

path string

요청의 리소스 경로.

value number

값입니다.

IncrementEntryRequest

입력 값을 증가시킵니다.

특성

amount number

입력 값에 대한 증가량입니다. 입력 값이 int64의 최대 값을 초과하면 9,223,372,036,854,775,807, 요청이 400 잘못된 요청 오류로 실패합니다.

ListEntriesResponse

부모 컬렉션에 있는 항목의 목록입니다.

특성

entries array<object>

지정된 범위의 항목.

nextPageToken string

다음 페이지를 검색하려면 page_token 으로 보낼 수 있는 토큰입니다. 이 필드를 생략하면 다음 페이지가 없습니다.

UpdateEntryRequest

새 값으로 제공된 항목을 업데이트합니다.

특성

value number

입력 값이 int64의 최대 값을 초과하면 값을 업데이트하려는 값이 9,223,372,036,854,775,807,040,040,040,040,040,040,040,040,040,040,040,040,040,040,040,040,040,040,040,040,040,040,040,040,040,040,0