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

OrderedDataStoreEntry

순서가 지정된 데이터 저장소의 키-값 항목.

특성

pathstring

주문된 데이터 저장소 항목의 리소스 경로.

형식: universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{ordered_data_store_scope_id}/entries/{ordered_data_store_entry_id}.

valuenumber

항목의 값.

항상 가장 가까운 정수로 반올림됩니다.

idstring
출력 전용

항목의 이름.

기본 URL
https://apis.roblox.com
OrderedDataStoreEntry 리소스
{

  "path": "universes/123/ordered-data-stores/some-ordered-data-store-id/scopes/some-ordered-data-store-scope-id/entries/some-ordered-data-store-entry-id",

  "value": "number",

  "id": "string"

}

OrderedDataStoreEntry

정렬된 데이터 저장소 항목 목록
베타

GET /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries

주문된 데이터 저장소의 엔트리 목록을 반환합니다.

범위
universe.ordered-data-store.scope.entry:read
요청경로 매개 변수
universe_idstring
필수

유니버스 ID.

ordered_data_store_idstring
필수

주문된 데이터 저장소 ID.

scope_idstring
필수

범위 ID.

쿼리 매개 변수
maxPageSizenumber

반환할 주문된 데이터 저장소 항목의 최대 수.서비스는 이 값보다 적은 값을 반환할 수 있습니다.지정되지 않으면 최대 10개의 주문된 데이터 저장소 항목이 반환됩니다.최대 값은 100이며 더 높은 값은 100으로 설정됩니다.

pageTokenstring

이전 호출에서 받은 페이지 토큰으로, 이후 페이지를 검색합니다.

페이징할 때 후속 호출에 제공된 모든 다른 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

orderBystring

지정된 경우 결과는 지정된 필드에 따라 순서가 지정됩니다.

값은 쉼표로 구분된 필드 목록이어야 하며, 선택적으로 필드마다 "desc" 접미사를 사용하여 값이 오름차순이 아닌 내림차순으로 정렬됩니다.. 연산자를 사용하여 하위 필드에 액세스할 수 있습니다.

결과는 다음 필드로 정렬될 수 있습니다: 값.

예: "값 설명".

filterstring

이 필드는 반환된 리소스를 필터링하기 위해 설정될 수 있습니다.

이 작업에 대해 두 가지 비교 연산자를 지원합니다: <= 및 >=.이러한 비교 연산자는 반환된 값에 대한 최소값과 최대값으로 작동합니다.최소값과 최대값 사이의 값에 필터링이 필요한 경우 사용자는 논리 연산자 &&를 사용할 수 있습니다.필터 식의 모든 토큰은 단일 공백으로 분리되어야 합니다.

예제 필터: entry <= 10 ; entry >= 10 && entry <= 30.

응답

부모 컬렉션의 OrderedDataStoreEntries 목록.

orderedDataStoreEntriesarray<OrderedDataStoreEntry>

지정된 순서대로 데이터 저장소 범위에서 순서대로 데이터 저장소 엔트리. The OrderedDataStoreEntries from the specified OrderedDataStoreScope.

nextPageTokenstring

다음 페이지를 검색하기 위해 pageToken 매개변수로 보낼 수 있는 토큰입니다. 이 필드가 생략되면 후속 페이지가 없습니다.

GET /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries
curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries?maxPageSize=10&pageToken={string}&orderBy={string}&filter={string}' \

  -H 'x-api-key: {your-api-key}'
응답
{

  "orderedDataStoreEntries": [

    {

      "path": "universes/123/ordered-data-stores/some-ordered-data-store-id/scopes/some-ordered-data-store-scope-id/entries/some-ordered-data-store-entry-id",

      "value": "number",

      "id": "string"

    }

  ],

  "nextPageToken": "string"

}

OrderedDataStoreEntry

정렬된 데이터 저장소 항목 생성
베타

POST /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries

제공된 ID와 값으로 항목을 생성합니다.

입력이 있으면 400 잘못된 요청을 반환합니다.

범위
universe.ordered-data-store.scope.entry:write
요청경로 매개 변수
universe_idstring
필수

유니버스 ID.

ordered_data_store_idstring
필수

주문된 데이터 저장소 ID.

scope_idstring
필수

범위 ID.

쿼리 매개 변수
idstring

주문된 데이터 저장소 엔트리에 사용할 ID로, 주문된 데이터 저장소 엔트리의 최종 리소스 경로가 됩니다.

이 값은 A 1-63자 문자열이어야 합니다. 우리는 소문자, 숫자 및 하이픈만 사용하는 것을 강력히 권장합니다.

요청 본문OrderedDataStoreEntry
응답OrderedDataStoreEntry
POST /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries
curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries?id=my-entry' \

  -H 'x-api-key: {your-api-key}' \

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

  --data '{

  "value": "number"

}'
응답
{

  "path": "universes/123/ordered-data-stores/some-ordered-data-store-id/scopes/some-ordered-data-store-scope-id/entries/some-ordered-data-store-entry-id",

  "value": "number",

  "id": "string"

}

OrderedDataStoreEntry

주문된 데이터 저장소 항목 가져오기
베타

GET /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}

지정된 항목을 가져옵니다.

범위
universe.ordered-data-store.scope.entry:read
요청경로 매개 변수
universe_idstring
필수

유니버스 ID.

ordered_data_store_idstring
필수

주문된 데이터 저장소 ID.

scope_idstring
필수

범위 ID.

entry_idstring
필수

엔트리 ID.

응답OrderedDataStoreEntry
GET /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}
curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}' \

  -H 'x-api-key: {your-api-key}'
응답
{

  "path": "universes/123/ordered-data-stores/some-ordered-data-store-id/scopes/some-ordered-data-store-scope-id/entries/some-ordered-data-store-entry-id",

  "value": "number",

  "id": "string"

}

OrderedDataStoreEntry

정렬된 데이터 저장소 항목 삭제
베타

DELETE /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}

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

성공하면 200 OK를 반환합니다. 항목이 존재하지 않으면 404 찾을 수 없음을 반환합니다.

범위
universe.ordered-data-store.scope.entry:write
요청경로 매개 변수
universe_idstring
필수

유니버스 ID.

ordered_data_store_idstring
필수

주문된 데이터 저장소 ID.

scope_idstring
필수

범위 ID.

entry_idstring
필수

엔트리 ID.

DELETE /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}
curl -L -X DELETE 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}' \

  -H 'x-api-key: {your-api-key}'

OrderedDataStoreEntry

주문된 데이터 저장소 항목 업데이트
베타

PATCH /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}

엔트리의 값을 업데이트합니다.

범위
universe.ordered-data-store.scope.entry:write
요청경로 매개 변수
universe_idstring
필수

유니버스 ID.

ordered_data_store_idstring
필수

주문된 데이터 저장소 ID.

scope_idstring
필수

범위 ID.

entry_idstring
필수

엔트리 ID.

쿼리 매개 변수
allowMissingboolean

설정된 경우 true이고 주문된 데이터 저장소 항목이 찾을 수 없으면 주문된 데이터 저장소 항목이 생성됩니다.

요청 본문OrderedDataStoreEntry
응답OrderedDataStoreEntry
PATCH /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}
curl -L -X PATCH 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}?allowMissing={boolean}' \

  -H 'x-api-key: {your-api-key}' \

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

  --data '{

  "value": "number"

}'
응답
{

  "path": "universes/123/ordered-data-stores/some-ordered-data-store-id/scopes/some-ordered-data-store-scope-id/entries/some-ordered-data-store-entry-id",

  "value": "number",

  "id": "string"

}

OrderedDataStoreEntry

증가 순서 데이터 저장소 항목 입력
베타

POST /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}:increment

지정된 항목의 값을 증가시킵니다. 기존 값과 증가량 모두 정수여야 합니다.

항목이 존재하지 않으면 지정된 값으로 항목을 생성합니다.

알려진 문제: 값이 유효한 범위를 넘어 증가될 수 있습니다.이런 일이 발생하면 반환된 값이 유효한 범위에 클램핑되지만 백엔드는 원래 값을 유지할 수 있습니다.이 동작은 이전 버전과의 호환성을 유지하기 위해 유지되지만 이 API의 미래 버전에서 변경될 수 있습니다.

범위
universe.ordered-data-store.scope.entry:write
요청경로 매개 변수
universe_idstring
필수

유니버스 ID.

ordered_data_store_idstring
필수

주문된 데이터 저장소 ID.

scope_idstring
필수

범위 ID.

entry_idstring
필수

엔트리 ID.

요청 본문
amountnumber

입력 값을 증가시키는 금액. 기존 값과 증가량 모두 정수여야 합니다.

응답OrderedDataStoreEntry
POST /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}:increment
curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}:increment' \

  -H 'x-api-key: {your-api-key}' \

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

  --data '{

  "amount": "number"

}'
응답
{

  "path": "universes/123/ordered-data-stores/some-ordered-data-store-id/scopes/some-ordered-data-store-scope-id/entries/some-ordered-data-store-entry-id",

  "value": "number",

  "id": "string"

}