일반적인 데이터 저장소

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

Datastores

https://apis.roblox.com/datastores

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

데이터 저장소 목록

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

매개 변수

universeId number

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

필요한 권한

데이터 저장소 나열

Entries

https://apis.roblox.com/datastores

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

목록 항목

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

매개 변수

universeId number

Path

필수

datastoreName string

scope string

allScopes boolean

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

필요한 권한

항목 키 나열

입장 얻기

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

매개 변수

universeId number

Path

필수

datastoreName string

entryKey string

scope string

요청

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

application/json

{
  "content-md5": "zuYxEhwuySMvOi8CitXImw==",
  "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-userids": [ 1, 2, 3 ]
}

roblox-entry-created-time string

last-modified string

roblox-entry-version string

roblox-entry-attributes string

roblox-entry-userids array<number>

content-md5 string

204 - No Content

필요한 권한

항목 읽기

입장 설정

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

매개 변수

universeId number

Path

필수

datastoreName string

entryKey string

matchVersion string

exclusiveCreate boolean

scope string

roblox-entry-attributes string

Header

roblox-entry-userids string

Header

content-md5 string

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

objectCreatedTime string

필요한 권한

항목 만들기
항목 업데이트

항목 삭제

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

매개 변수

universeId number

Path

필수

datastoreName string

entryKey string

scope string

요청

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"

응답

204 - No Content

필요한 권한

항목 삭제

증가 항목 입력

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

매개 변수

universeId number

Path

필수

datastoreName string

entryKey string

incrementBy number

scope string

roblox-entry-attributes string

Header

roblox-entry-userids string

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

application/json

{
  "content-md5": "K4phWUsfTE2wkCqKOVztkw==",
  "roblox-entry-version": "08D9E6A3F2188CFF.0000000009.08D9E6DF74AC5F42.01",
  "roblox-entry-created-time": "2022-02-02T23:30:06.5388799+00:00",
  "roblox-entry-version-created-time": "2022-02-03T06:36:05.9184962+00:00",
  "roblox-entry-userids": []
}

roblox-entry-created-time string

last-modified string

roblox-entry-version string

roblox-entry-attributes string

roblox-entry-userids array<number>

content-md5 string

204 - No Content

필요한 권한

항목 만들기
항목 업데이트

버전 확인

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

매개 변수

universeId number

Path

필수

datastoreName string

entryKey string

versionId string

scope string

요청

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

application/json

{
  "content-md5": "sTf90fedVsft8zZf6nUg8g==",
  "roblox-entry-version": "08D9E6A3F2188CFF.0000000003.08D9E6DE485A7680.01",
  "roblox-entry-created-time": "2022-02-02T23:30:06.5388799+00:00",
  "roblox-entry-version-created-time": "2022-02-03T06:27:42.0652160+00:00",
  "roblox-entry-attributes": {},
  "roblox-entry-userids": [ 269323 ]
}

roblox-entry-created-time string

last-modified string

roblox-entry-version string

필요한 권한

버전 읽기

한도

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

목록 버전 관리

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

매개 변수

universeId number

Path

필수

datastoreName string

entryKey string

scope string

cursor string

startTime string

endTime string

sortOrder string

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

objectCreatedTime string

기타 상태 코드

필요한 권한

버전 나열

개체

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

DataStore

특성

name string

createdTime string

EntryVersion

특성

version string

deleted boolean

contentLength number

createdTime string

objectCreatedTime string