標準データストア

*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。

Datastores

https://apis.roblox.com/datastores

データストアのリスト

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

エントリをリストする

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

必要な権限

エントリを設定

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"

レスポンス

必要な権限

増分エントリ

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

必要な権限

エントリバージョンを取得

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

必要な権限

限度

リストエントリバージョン

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