표준 데이터 저장소

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

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

Datastores

https://apis.roblox.com/datastores

다음 끝점은 기준 URL과 관련된 경로에서 사용할 수 있습니다.

데이터 저장소 목록

GET /v1/universes/{universeId}/standard-datastores

경험의 데이터 저장소 목록을 반환합니다.

매개 변수

universeId number

액세스하려는 데이터 저장소와 경험의 식별자.크리에이터 대시보드에서 경험의 유니버스 ID를 복사할 수 있습니다.

Path
필수
cursor string

다음 데이터 세트를 요청하도록 제공합니다. 참조 커서.

limit number

반환할 아이템의 최대 수.각 호출은 하나의 파티션에서 목표가 부족할 때 지정된 값보다 적은 수를 반환할 수 있으므로, 한 파티션에서 목표가 부족할 경우 각 호출은 하나의 파티션에서만 읽을 수 있습니다.

prefix string

이 접두사를 사용하여 데이터 저장소만 반환하도록 제공합니다.

요청

curl
curl --include --location --request GET "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores" \

--header "x-api-key: ${API_KEY}" \

--get \

-d "prefix=Player" \

-d "limit=5"

응답

200 - OK
반환: object
application/json
{

  "datastores": [

    {

      "name": "PlayerInventory",

      "createdTime": "2022-02-18T22:38:59.9244932Z"

    },

    {

      "name": "PlayerExperience",

      "createdTime": "2022-02-18T23:00:10.4773508Z"

    },

    {

      "name": "PlayerWeapons",

      "createdTime": "2022-02-18T23:00:22.3725681Z"

    },

    {

      "name": "PlayerArmor",

      "createdTime": "2022-02-18T22:59:33.8472882Z"

    },

    {

      "name": "PlayerHP",

      "createdTime": "2022-02-18T22:58:47.6904028Z"

    }

  ],

  "nextPageCursor": "..."

}
data array<object>

대상 경험에 있는 데이터 저장소 배열.

nextPageCursor string

요청한 결과 설정더 많은 데이터가 사용 가능하다는 것을 나타냅니다. 참조 커서.

필요한 권한

이 엔드포인트를 호출하려면 다음 API 키 권한이 필요합니다. 적절한 키 생성에 대한 자세한 내용은 API 키 관리에서 확인하세요.

  • 데이터 저장소 나열

Entries

https://apis.roblox.com/datastores

다음 끝점은 기준 URL과 관련된 경로에서 사용할 수 있습니다.

목록 항목 표시

GET /v1/universes/{universeId}/standard-datastores/datastore/entries

데이터 상점내의 엔트리 키 목록을 반환합니다.

매개 변수

universeId number

액세스하려는 데이터 저장소와 경험의 식별자.크리에이터 대시보드에서 경험의 유니버스 ID를 복사할 수 있습니다.

Path
필수
datastoreName string

데이터 상점이름.

scope string

기본값은 global 입니다. 참조하십시오 범위.

allScopes boolean

모든 범위에서 키를 반환하려면 true로 설정합니다.

prefix string

이 접두사를 사용하여 키만 반환하도록 제공합니다.

cursor string

다음 데이터 세트를 요청하도록 제공합니다. 참조 커서.

limit number

반환할 아이템의 최대 수.각 호출은 하나의 파티션에서 목표가 부족할 때 지정된 값보다 적은 수를 반환할 수 있으므로, 한 파티션에서 목표가 부족할 경우 각 호출은 하나의 파티션에서만 읽을 수 있습니다.

요청

curl
curl --include --location --request GET "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores/datastore/entries" \

--header "x-api-key: ${API_KEY}" \

--get \

-d "datastoreName=Coins" \

-d "prefix=" \

-d "limit=5"

응답

200 - OK
반환: object
application/json
{

  "keys": [

    {

      "key": "269323"

    }

  ],

  "nextPageCursor": "eyJ2ZXJzaW9uIjoxLCJjdXJzb3IiOiIzIyJ9"

}
keys array<string>

대상 데이터 상점내의 입력 키 배열.

nextPageCursor string

요청한 결과 설정더 많은 데이터가 사용 가능하다는 것을 나타냅니다. 참조 커서.

필요한 권한

이 엔드포인트를 호출하려면 다음 API 키 권한이 필요합니다. 적절한 키 생성에 대한 자세한 내용은 API 키 관리에서 확인하세요.

  • 항목 키 나열

엔트리 가져오기

GET /v1/universes/{universeId}/standard-datastores/datastore/entries/entry

엔트리와 관련된 값과 메타데이터를 반환합니다.

메타데이터는 다음과 같은 응답 헤더에서 찾을 수 있습니다: metadata can be found in the response headers like the 팔로잉:

content-md5: zuYxEhwuySMv0i8CitXImw==

roblox-entry-version: 08D9E6A3F2188CFF.0000000001.08D9E6A3F2188CFF.01

roblox-entry-created-time: 2022-02-02T23:30:06.5388799+00:00

roblox-entry-version-created-time: 2022-02-02T23:30:06.5388799+00:00

roblox-entry-attributes: { "myAttribute": "myValue" }

roblox-entry-userids: [1, 2, 3]

| 헤더 | 설명 | |---|---| | content-md5 | 콘텐츠의 기본-64 인코딩된 MD5 체크섬.참조 콘텐츠-MD5.| | roblox-entry-version | 반환된 항목의 버전.| | roblox-entry-created-time | 항목이 생성된 시간.| | roblox-entry-version-created-time | 이 특정 버전이 생성된 시간.| | roblox-entry-attributes | 입력과 태그된 특성.JSON 맵 개체를 직렬화합니다.| | roblox-entry-userids | 입력과 함께 태그된 Roblox 사용자 ID 목록을 쉼표로 구분합니다. |

매개 변수

universeId number

액세스하려는 데이터 저장소와 경험의 식별자.크리에이터 대시보드에서 경험의 유니버스 ID를 복사할 수 있습니다.

Path
필수
datastoreName string

데이터 상점이름.

entryKey string

입력을 식별하는 키.

scope string

기본값은 global 입니다. 참조하십시오 범위.

요청

curl
curl --include --location --request GET "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores/datastore/entries/entry" \

--header "x-api-key: ${API_KEY}" \

--get \

-d "datastoreName=Coins" \

-d "entryKey=269323"

응답

200 - OK
항목을 성공적으로 검색했습니다.
반환: object

필요한 권한

이 엔드포인트를 호출하려면 다음 API 키 권한이 필요합니다. 적절한 키 생성에 대한 자세한 내용은 API 키 관리에서 확인하세요.

  • 항목 읽기

입력 설정

POST /v1/universes/{universeId}/standard-datastores/datastore/entries/entry

엔트리와 관련된 값, 메타데이터 및 사용자 ID를 설정합니다.

매개 변수

universeId number

액세스하려는 데이터 저장소와 경험의 식별자.크리에이터 대시보드에서 경험의 유니버스 ID를 복사할 수 있습니다.

Path
필수
datastoreName string

데이터 상점이름.

entryKey string

입력을 식별하는 키.

matchVersion string

현재 버전이 이것과 일치하는 경우에만 업데이트를 제공합니다.

exclusiveCreate boolean

존재하지 않는 경우에만 항목을 생성합니다.

scope string

기본값은 global 입니다. 참조하십시오 범위.

roblox-entry-attributes string

새 버전의 항목에 연결될 특성. JSON 맵 개체에 의해 직렬화됩니다. 제공되지 않으면 기존 특성이 지워집니다.

Header
roblox-entry-userids string

입력과 함께 태그가 지정된 Roblox 사용자 ID 목록을 쉼표로 구분합니다. 제공되지 않으면 기존 사용자 ID가 지워집니다.

Header
content-md5 string

콘텐츠의 기본-64 인코딩된 MD5 체크섬. 참조하십시오 콘텐츠-MD5.

Header

요청

curl
curl --include --location --request POST "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores/datastore/entries/entry?datastoreName=Coins&entryKey=269323" \

--header "x-api-key: ${API_KEY}" \

--header "content-md5: IGPBYI1uC6+AJJxC4r5YBA==" \

--header "content-type: application/json" \

--header "roblox-entry-userids: [269323]" \

--header "roblox-entry-attributes: {}" \

--d "value"

응답

200 - OK
반환: object
version string

자격 조건 항목의 버전 이름.

deleted boolean

항목이 삭제되었는지 여부를 나타냅니다.

contentLength number

콘텐츠의 길이.

createdTime string

버전이 ISO 시간 형식으로 만들어진 시점의 타임스탬프.

objectCreatedTime string

데이터 저장소가 ISO 시간 형식으로 만들어진 시점의 타임스탬프.

필요한 권한

이 엔드포인트를 호출하려면 다음 API 키 권한이 필요합니다. 적절한 키 생성에 대한 자세한 내용은 API 키 관리에서 확인하세요.

  • 항목 만들기

  • 항목 업데이트

항목 삭제

DELETE /v1/universes/{universeId}/standard-datastores/datastore/entries/entry

묘비 버전을 만들어 입력을 삭제로 표시합니다. 입력은 30일 후에 영구적으로 삭제됩니다.

매개 변수

universeId number

액세스하려는 데이터 저장소와 경험의 식별자.크리에이터 대시보드에서 경험의 유니버스 ID를 복사할 수 있습니다.

Path
필수
datastoreName string

데이터 상점이름.

entryKey string

입력을 식별하는 키.

scope string

기본값은 global 입니다. 참조하십시오 범위.

요청

curl
curl --include --location --request DELETE "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores/datastore/entries/entry" \

--header "x-api-key: ${API_KEY}" \

--get \

-d "datastoreName=Coins" \

-d "entryKey=269323"

응답

필요한 권한

이 엔드포인트를 호출하려면 다음 API 키 권한이 필요합니다. 적절한 키 생성에 대한 자세한 내용은 API 키 관리에서 확인하세요.

  • 항목 삭제

증가 항목 입력

POST /v1/universes/{universeId}/standard-datastores/datastore/entries/entry/increment

입력의 값을 지정된 금액으로 증가시키거나, 해당 금액으로 새 입력을 생성합니다. 입력과 메타데이터를 반환합니다.

메타데이터는 다음과 같은 응답 헤더에서 찾을 수 있습니다: metadata can be found in the response headers like the 팔로잉:

content-md5: zuYxEhwuySMv0i8CitXImw==

roblox-entry-version: 08D9E6A3F2188CFF.0000000001.08D9E6A3F2188CFF.01

roblox-entry-created-time: 2022-02-02T23:30:06.5388799+00:00

roblox-entry-version-created-time: 2022-02-02T23:30:06.5388799+00:00

roblox-entry-attributes: { "myAttribute": "myValue" }

roblox-entry-userids: [1, 2, 3]

| 헤더 | 설명 | |---|---| | content-md5 | 콘텐츠의 기본-64 인코딩된 MD5 체크섬.참조 콘텐츠-MD5.| | roblox-entry-version | 반환된 항목의 버전.| | roblox-entry-created-time | 항목이 생성된 시간.| | roblox-entry-version-created-time | 이 특정 버전이 생성된 시간.| | roblox-entry-attributes | 입력과 태그된 특성.JSON 맵 개체를 직렬화합니다.| | roblox-entry-userids | 입력과 함께 태그된 Roblox 사용자 ID 목록을 쉼표로 구분합니다. |

매개 변수

universeId number

액세스하려는 데이터 저장소와 경험의 식별자.크리에이터 대시보드에서 경험의 유니버스 ID를 복사할 수 있습니다.

Path
필수
datastoreName string

데이터 상점이름.

entryKey string

입력을 식별하는 키.

incrementBy number

항목을 증가시킬 금액 또는 존재하지 않는 경우 시작 값입니다.

scope string

기본값은 global 입니다. 참조하십시오 범위.

roblox-entry-attributes string

새 버전의 항목에 연결될 특성. JSON 맵 개체에 의해 직렬화됩니다. 제공되지 않으면 기존 특성이 지워집니다.

Header
roblox-entry-userids string

입력이 태그된 로블록스 사용자 ID 목록이 쉼표로 구분됩니다. 제공되지 않으면 기존 사용자 ID가 지워집니다.

Header

요청

curl
curl --include --location --request POST "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores/datastore/entries/entry/increment" \

--header "x-api-key: ${API_KEY}" \

--header 'content-length: 0' \

--get \

-d "datastoreName=Coins" \

-d "entryKey=269323" \

-d "incrementBy=3"

응답

200 - OK
증가된 후 최신 버전의 항목을 반환합니다.
반환: object

필요한 권한

이 엔드포인트를 호출하려면 다음 API 키 권한이 필요합니다. 적절한 키 생성에 대한 자세한 내용은 API 키 관리에서 확인하세요.

  • 항목 만들기

  • 항목 업데이트

입력 버전 가져오기

GET /v1/universes/{universeId}/standard-datastores/datastore/entries/entry/versions/version

특정 버전의 항목의 값과 메타데이터를 반환합니다.

메타데이터는 다음과 같은 응답 헤더에서 찾을 수 있습니다: metadata can be found in the response headers like the 팔로잉:

content-md5: zuYxEhwuySMv0i8CitXImw==

roblox-entry-version: 08D9E6A3F2188CFF.0000000001.08D9E6A3F2188CFF.01

roblox-entry-created-time: 2022-02-02T23:30:06.5388799+00:00

roblox-entry-version-created-time: 2022-02-02T23:30:06.5388799+00:00

roblox-entry-attributes: { "myAttribute": "myValue" }

roblox-entry-userids: [1, 2, 3]

| 헤더 | 설명 | |---|---| | content-md5 | 콘텐츠의 기본-64 인코딩된 MD5 체크섬.참조 콘텐츠-MD5.| | roblox-entry-version | 반환된 항목의 버전.| | roblox-entry-created-time | 항목이 생성된 시간.| | roblox-entry-version-created-time | 이 특정 버전이 생성된 시간.| | roblox-entry-attributes | 입력과 태그된 특성.JSON 맵 개체를 직렬화합니다.| | roblox-entry-userids | 입력과 함께 태그된 Roblox 사용자 ID 목록을 쉼표로 구분합니다. |

매개 변수

universeId number

액세스하려는 데이터 저장소와 경험의 식별자.크리에이터 대시보드에서 경험의 유니버스 ID를 복사할 수 있습니다.

Path
필수
datastoreName string

데이터 상점이름.

entryKey string

입력을 식별하는 키.

versionId string

검사할 버전.

scope string

기본값은 global 입니다. 참조하십시오 범위.

요청

curl
curl --include --location --request GET "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores/datastore/entries/entry/versions/version" \

--header "x-api-key: ${API_KEY}" \

--get \

-d "datastoreName=Coins" \

-d "entryKey=269323" \

-d "versionId=08D9E6A3F2188CFF.0000000003.08D9E6DE485A7680.01"

응답

200 - OK
항목을 성공적으로 검색했습니다.
반환: object

필요한 권한

이 엔드포인트를 호출하려면 다음 API 키 권한이 필요합니다. 적절한 키 생성에 대한 자세한 내용은 API 키 관리에서 확인하세요.

  • 버전 읽기

한도

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

목록 항목 버전 표시

GET /v1/universes/{universeId}/standard-datastores/datastore/entries/entry/versions

엔트리에 대한 버전 목록을 반환합니다.

매개 변수

universeId number

액세스하려는 데이터 저장소와 경험의 식별자.크리에이터 대시보드에서 경험의 유니버스 ID를 복사할 수 있습니다.

Path
필수
datastoreName string

데이터 상점이름.

entryKey string

입력을 식별하는 키.

scope string

기본값은 global 입니다. 참조하십시오 범위.

cursor string

다음 데이터 세트를 요청하도록 제공(커서 참조)

startTime string

이 시점보다 이전 버전을 포함하지 않도록 지정합니다.

endTime string

이 시점 이후의 버전을 포함하지 않도록 제공합니다.

sortOrder string

Either Ascending (이전 버전부터) 또는 Descending (나중에 출시된 버전부터).

limit number

반환할 아이템의 최대 수.각 호출은 하나의 파티션에서 목표가 부족할 때 지정된 값보다 적은 수를 반환할 수 있으므로, 한 파티션에서 목표가 부족할 경우 각 호출은 하나의 파티션에서만 읽을 수 있습니다.

요청

curl
curl --include --location --request GET "https://apis.roblox.com/datastores/v1/universes/3310576216/standard-datastores/datastore/entries/entry/versions" \

--header "x-api-key: ${API_KEY}" \

--get \

-d "datastoreName=Coins" \

-d "entryKey=269323" \

-d "limit=5"

응답

200 - OK
반환: object
version string

자격 조건 항목의 버전 이름.

deleted boolean

항목이 삭제되었는지 여부를 나타냅니다.

contentLength number

콘텐츠의 길이.

createdTime string

버전이 ISO 시간 형식으로 만들어진 시점의 타임스탬프.

objectCreatedTime string

데이터 저장소가 ISO 시간 형식으로 만들어진 시점의 타임스탬프.

필요한 권한

이 엔드포인트를 호출하려면 다음 API 키 권한이 필요합니다. 적절한 키 생성에 대한 자세한 내용은 API 키 관리에서 확인하세요.

  • 버전 나열

개체

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

DataStore

이름과 생성 시간이 있는 데이터 저장소 개체.

특성

name string

데이터 상점이름.

createdTime string

데이터 저장소가 ISO 시간 형식으로 만들어진 시점의 타임스탬프.

EntryVersion

List Entry Versions 메서드에서 반환된 입력 버전 개체.

특성

version string

자격 조건 항목의 버전 이름.

deleted boolean

항목이 삭제되었는지 여부를 나타냅니다.

contentLength number

콘텐츠의 길이.

createdTime string

버전이 ISO 시간 형식으로 만들어진 시점의 타임스탬프.

objectCreatedTime string

데이터 저장소가 ISO 시간 형식으로 만들어진 시점의 타임스탬프.