Stockage de données ordonné (Beta)

*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

Cette page inclut la documentation de référence pour travailler avec des magasins de données ordonnés.Pour plus d'informations sur l'utilisation de l'API, voir gérer les demandes d'API pour les magasins de données et le guide d'utilisation.

OrderedDataStores

https://apis.roblox.com/ordered-data-stores

Liste

GET /v1/universes/{universeId}/orderedDataStores/{orderedDataStore}/scopes/{scope}/entries

Renvoie une liste d'entrées d'un boutiquede données ordonné.

Paramètres

universeId string

L'identifiant de l'expérience avec des magasins de données commandés que vous souhaitez accès.Voir ID de l'univers sur la façon de le copier sur Tableau de bord du créateur.

Path
Requis
orderedDataStore string

Le nom du boutiquede données ciblé commandé.

Path
Requis
scope string

Le nom du scope du magasin de données. Voir Scopes .

Path
Requis
max_page_size number

Le nombre maximum d'entrées à renvoyer.Le service peut retourner moins que cette valeur.La valeur par défaut est 10 .La valeur maximale est 100 , et toute entrée au-dessus de 100 est forcée à 100 .

page_token string

Un jeton de page reçu d'un appel précédent List.Fournissez ceci pour récupérer la page suivante.Lors de la pagination, tous les autres paramètres fournis à List doivent correspondre à l'appel fournissant le jeton de page.

order_by string

La direction d'énumeration. L'ordre par défaut est ascendant. Saisissez un suffixe desc pour descendre.

filter string

La gamme de valeurs qualifiantes des entrées à renvoyer. Voir filtres .

Requête

curl

curl --location 'https://apis.roblox.com/ordered-data-stores/v1/universes/<universeId>/orderedDataStores/<orderedDataStore>/scopes/<scope>/entries' \
--header 'x-api-key: <insert-api-key>'

Réponse

200 - OK
OK
Renvoie une object
entries array<object>

Les entrées de la portée spécifiée.

nextPageToken string

Un jeton, qui peut être envoyé comme page_token pour récupérer la page suivante. Si ce champ est omis, il n'y a pas de pages suivantes.

Autorisations requises

Les autorisations suivantes de la clé API sont requises pour appeler ce point de terminaison. Pour plus d'informations sur la génération de clés appropriées, voir [Gestion des clés d'API] (/cloud/auth/api-keys).

  • Lire

Créer

POST /v1/universes/{universeId}/orderedDataStores/{orderedDataStore}/scopes/{scope}/entries

Crée une nouvelle entrée avec la valeur de contenu fournie.

Paramètres

universeId string

L'identifiant de l'expérience avec des magasins de données commandés que vous souhaitez accès.Voir ID de l'univers sur la façon de le copier sur Tableau de bord du créateur.

Path
Requis
orderedDataStore string

Le nom du boutiquede données commandé.

Path
Requis
scope string

Le nom du scope du magasin de données. Voir Scopes .

Path
Requis
id string

Le nom de l'entrée.

Requis

Requête

curl

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>
}'

Réponse

200 - OK
OK
Renvoie une object
id string

Le nom de l'entrée

path string

Le chemin de ressource de la demande.

value number

La valeur de l'entrée.

Autorisations requises

Les autorisations suivantes de la clé API sont requises pour appeler ce point de terminaison. Pour plus d'informations sur la génération de clés appropriées, voir [Gestion des clés d'API] (/cloud/auth/api-keys).

  • Écrire

Obtenir

GET /v1/universes/{universeId}/orderedDataStores/{orderedDataStore}/scopes/{scope}/entries/{entry}

Obtient et renvoie l'entrée spécifiée.

Paramètres

universeId string

L'identifiant de l'expérience avec des magasins de données commandés que vous souhaitez accès.Voir ID de l'univers sur la façon de le copier sur Tableau de bord du créateur.

Path
Requis
orderedDataStore string

Le nom du boutiquede données commandé.

Path
Requis
scope string

Le nom du scope du magasin de données. Voir Scopes .

Path
Requis
entry string

L'ID d'entrée.

Path
Requis

Requête

curl

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>'

Réponse

200 - OK
OK
Renvoie une object
id string

Le nom de l'entrée

path string

Le chemin de ressource de la demande.

value number

La valeur de l'entrée.

Autorisations requises

Les autorisations suivantes de la clé API sont requises pour appeler ce point de terminaison. Pour plus d'informations sur la génération de clés appropriées, voir [Gestion des clés d'API] (/cloud/auth/api-keys).

  • Lire

Supprimer

DELETE /v1/universes/{universeId}/orderedDataStores/{orderedDataStore}/scopes/{scope}/entries/{entry}

Supprime l'entrée spécifiée.

Paramètres

universeId string

L'identifiant de l'expérience avec des magasins de données commandés que vous souhaitez accès.Voir ID de l'univers sur la façon de le copier sur Tableau de bord du créateur.

Path
Requis
orderedDataStore string

Le nom du boutiquede données commandé.

Path
Requis
scope string

Le nom du scope du magasin de données. Voir Scopes .

Path
Requis
entry string

L'ID d'entrée.

Path
Requis

Requête

curl

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>'

Réponse

Autorisations requises

Les autorisations suivantes de la clé API sont requises pour appeler ce point de terminaison. Pour plus d'informations sur la génération de clés appropriées, voir [Gestion des clés d'API] (/cloud/auth/api-keys).

  • Écrire

Mise à jour

PATCH /v1/universes/{universeId}/orderedDataStores/{orderedDataStore}/scopes/{scope}/entries/{entry}

Mise à jour d'une valeur d'entrée et retour de l'entrée mise à jour.

Paramètres

universeId string

L'identifiant de l'expérience avec des magasins de données commandés que vous souhaitez accès.Voir ID de l'univers sur la façon de le copier sur Tableau de bord du créateur.

Path
Requis
orderedDataStore string

Le nom du boutiquede données commandé.

Path
Requis
scope string

Le nom du scope du magasin de données. Voir Scopes .

Path
Requis
entry string

L'ID d'entrée.

Path
Requis
allow_missing boolean

Le drapeau pour permettre la création d'une entrée si l'entrée n'existe pas. Voir Autoriser les drapeaux manquants.

Requête

curl

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>
}'

Réponse

200 - OK
OK
Renvoie une object
id string

Le nom de l'entrée

path string

Le chemin de ressource de la demande.

value number

La valeur de l'entrée.

Autorisations requises

Les autorisations suivantes de la clé API sont requises pour appeler ce point de terminaison. Pour plus d'informations sur la génération de clés appropriées, voir [Gestion des clés d'API] (/cloud/auth/api-keys).

  • Écrire

Incrément

POST /v1/universes/{universeId}/orderedDataStores/{orderedDataStore}/scopes/{scope}/entries/{entry}:increment

Augmente la valeur de la clé de la quantité fournie et renvoie l'entrée mise à jour.

Problème connu : les valeurs d'entrée peuvent augmenter au-delà de la plage valide et cela peut persister dans le backend. Les valeurs renvoyées s'ajustent à la plage valide.

Paramètres

universeId string

L'identifiant de l'expérience avec des magasins de données commandés que vous souhaitez accès.Voir ID de l'univers sur la façon de le copier sur Tableau de bord du créateur.

Path
Requis
orderedDataStore string

Le nom du boutiquede données commandé.

Path
Requis
scope string

Le nom du scope du magasin de données. Voir Scopes .

Path
Requis
entry string

L'ID d'entrée.

Path
Requis

Requête

curl

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>
}'

Réponse

200 - OK
OK
Renvoie une object
id string

Le nom de l'entrée

path string

Le chemin de ressource de la demande.

value number

La valeur de l'entrée.

Autorisations requises

Les autorisations suivantes de la clé API sont requises pour appeler ce point de terminaison. Pour plus d'informations sur la génération de clés appropriées, voir [Gestion des clés d'API] (/cloud/auth/api-keys).

  • Écrire

Objets

Les objets suivants décrivent les charges utiles qui sont acceptées ou renvoyées. Voir chaque point de terminaison individuel pour plus d'informations sur l'utilisation de ces objets.

CreateEntryRequest

Crée une nouvelle entrée avec la valeur fournie.

Attributs

value number

La valeur pour définir la nouvelle entrée.Si la valeur d'entrée dépasse la valeur maximale prise en charge par int64, qui est de 9,223,372,036,854,775,807, la demande échoue avec une erreur 400 Request Time-out.

Entry

Représente une entrée.

Attributs

id string

Le nom de l'entrée

path string

Le chemin de ressource de la demande.

value number

La valeur de l'entrée.

IncrementEntryRequest

Augmente la valeur d'entrée d'incréments.

Attributs

amount number

Le montant à augmenter par la valeur d'entrée.Si la valeur d'entrée dépasse la valeur maximale prise en charge par int64, qui est de 9,223,372,036,854,775,807, la demande échoue avec une erreur 400 Request Time-out.

ListEntriesResponse

Une liste d'entrées dans la collectionsparent.

Attributs

entries array<object>

Les entrées de la portée spécifiée.

nextPageToken string

Un jeton, qui peut être envoyé comme page_token pour récupérer la page suivante. Si ce champ est omis, il n'y a pas de pages suivantes.

UpdateEntryRequest

Mise à jour de l'entrée fournie avec une nouvelle valeur.

Attributs

value number

La valeur pour mettre à jour l'entrée.Si la valeur d'entrée dépasse la valeur maximale prise en charge par int64, qui est de 9,223,372,036,854,775,807, la demande échoue avec une erreur 400 Request Time-out.