주문형 데이터 저장소(베타)
*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.
이 페이지에는 주문된 데이터 저장소와 작업하는 방법에 대한 참조 문서가 포함되어 있습니다. 자세한 내용은 API 사용 가이드 및 데이터 저장소 사용 가이드를 참조하십시오.
OrderedDataStores
목록
주문된 데이터 상점항목 목록을 반환합니다.
매개 변수
액세스하려는 주문형 데이터 저장소의 경험의 식별자. 참조 크리에이터 대시보드에서 복사하는 방법에 대해 유니버스 ID를 참조하십시오.
대상 주문 데이터 상점이름입니다.
데이터 저장소 범위의 이름입니다. 보세요 범위.
반환할 항목의 최대 개수입니다. 서비스는 이 값보다 작은 값을 반환할 수 있습니다. 기본 값은 10 입니다. 최대 값은 100 입니다. 100보다 큰 입력은 100 로 강제됩니다.
이전 List 호출에서 받은 페이지 토큰. 이 페이지를 검색하려면 이 페이지 토큰을 제공하십시오. 지불 시 다른 모든 매개 변수는 List에 일치해야 합니다.
열거 방향입니다. 기본적으로 순서는 오름차순입니다. 내림차순에 대해 desc 접두사를 입력합니다.
반환할 항목의 품질 값 범위. 자세한 내용은 필터를 참조하십시오.
요청
curl --location 'https://apis.roblox.com/ordered-data-stores/v1/universes/<universeId>/orderedDataStores/<orderedDataStore>/scopes/<scope>/entries' \
--header 'x-api-key: <insert-api-key>'
응답
생성
지정된 콘텐츠 값으로 새로운 항목을 생성합니다.
매개 변수
액세스하려는 주문형 데이터 저장소의 경험의 식별자. 참조 크리에이터 대시보드에서 복사하는 방법에 대해 유니버스 ID를 참조하십시오.
주문된 데이터 상점이름입니다.
데이터 저장소 범위의 이름입니다. 보세요 범위.
항목의 이름입니다.
지정된 값으로 새로운 항목을 생성합니다.
요청
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>
}'
응답
가져다 가기
지정된 항목을 가져와 반환합니다.
매개 변수
액세스하려는 주문형 데이터 저장소의 경험의 식별자. 참조 크리에이터 대시보드에서 복사하는 방법에 대해 유니버스 ID를 참조하십시오.
주문된 데이터 상점이름입니다.
데이터 저장소 범위의 이름입니다. 보세요 범위.
입력 ID.
요청
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>'
응답
삭제
지정된 항목을 삭제합니다.
매개 변수
액세스하려는 주문형 데이터 저장소의 경험의 식별자. 참조 크리에이터 대시보드에서 복사하는 방법에 대해 유니버스 ID를 참조하십시오.
주문된 데이터 상점이름입니다.
데이터 저장소 범위의 이름입니다. 보세요 범위.
입력 ID.
요청
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>'
응답
업데이트
입력 값을 업데이트하고 업데이트된 입력을 반환합니다.
매개 변수
액세스하려는 주문형 데이터 저장소의 경험의 식별자. 참조 크리에이터 대시보드에서 복사하는 방법에 대해 유니버스 ID를 참조하십시오.
주문된 데이터 상점이름입니다.
데이터 저장소 범위의 이름입니다. 보세요 범위.
입력 ID.
새 값으로 제공된 항목을 업데이트합니다.
입력이 없는 경우 입력을 허용하도록 하는 플래그입니다. 자세한 내용은 허용 누락된 플래그를 참조하십시오.
요청
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>
}'
응답
증가량
지정된 값으로 키의 값을 증가하고 업데이트된 항목을 반환합니다.
알려진 문제: 입력 값이 유효한 범위를 초과하면 백엔드에서 지속될 수 있습니다. 반환된 값은 유효한 범위에 맞춥니다.
매개 변수
액세스하려는 주문형 데이터 저장소의 경험의 식별자. 참조 크리에이터 대시보드에서 복사하는 방법에 대해 유니버스 ID를 참조하십시오.
주문된 데이터 상점이름입니다.
데이터 저장소 범위의 이름입니다. 보세요 범위.
입력 ID.
입력 값을 증가시킵니다.
요청
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>
}'
응답
개체
다음 개체는 수락되거나 반환되는 페이로드를 설명합니다. 이러한 개체가 사용되는 시기에 대한 자세한 정보는 각 개별 끝점을 참고하세요.CreateEntryRequest
지정된 값으로 새로운 항목을 생성합니다.
특성
새 항목을 설정하는 값입니다. 입력 값이 int64의 최대 값을 초과하면 9,223,372,036,854,775,807, 요청이 400 잘못된 요청 오류로 실패합니다.
Entry
입력을 나타냅니다.
특성
항목의 이름
요청의 리소스 경로.
값입니다.
IncrementEntryRequest
입력 값을 증가시킵니다.
특성
입력 값에 대한 증가량입니다. 입력 값이 int64의 최대 값을 초과하면 9,223,372,036,854,775,807, 요청이 400 잘못된 요청 오류로 실패합니다.
ListEntriesResponse
부모 컬렉션에 있는 항목의 목록입니다.
특성
지정된 범위의 항목.
다음 페이지를 검색하려면 page_token 으로 보낼 수 있는 토큰입니다. 이 필드를 생략하면 다음 페이지가 없습니다.
UpdateEntryRequest
새 값으로 제공된 항목을 업데이트합니다.
특성
입력 값이 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