Bestellte Datenspeicher (Beta)
*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.
Diese Seite enthält Referenzdokumentation für die Arbeit mit bestellten Datenlagern.Für weitere Informationen zur Verwendung der API siehe API-Anfragen für Datenbanken bearbeiten und den Nutzungsleitfaden.
OrderedDataStores
Zur Liste
Gibt eine Liste von Einträgen aus einem bestellten Storezurück.
Parameter
Die Identifikator des Erlebnisses mit bestellten Datenlagern, auf die Sie Zugriffmöchten.Siehe Universitäts-ID auf, wie sie auf Creator-Dashboard kopiert werden kann.
Der Name des angeforderten Store.
Der Name des Datenspeicherbereichs. Siehe Bereiche.
Die maximale Anzahl von Einträgen, die zurückzukehren sind.Der Dienst kann weniger als diesen Wert zurückgeben.Der Standardwert ist 10.Der maximale Wert ist 100 , und jede Eingabe über 100 wird gezwungen zu 100 .
Ein Seiten-Token, das von einem früheren List Anruf empfangen wurde.Geben Sie dies an, um die nachfolgende Seite abzurufen.Wenn Seiten nummeriert werden, müssen alle anderen Parameter, die an List bereitgestellt wurden, mit dem Anruf übereinstimmen, der die Seiten-Token bereitstellt.
Die Enumerationsrichtung. Die Sortierung erfolgt standardmäßig aufsteigend. Geben Sie einen desc -Suffix für die Absteigerung ein.
Die Reihe von qualifizierenden Werten von Einträgen, die zurückgebensind. Siehe Filter.
Anfrage
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ückmeldung
Erforderliche Berechtigungen
Die folgenden API-Schlüssel-Berechtigungen werden benötigt, um diesen Endpunkt aufzurufen. Für weitere Informationen zur Erzeugung korrekter Schlüssel siehe API-Schlüssel verwalten.
Erstellen
Erstellt einen neuen Eintrag mit dem angegebenen Inhaltswert.
Parameter
Die Identifikator des Erlebnisses mit bestellten Datenlagern, auf die Sie Zugriffmöchten.Siehe Universitäts-ID auf, wie sie auf Creator-Dashboard kopiert werden kann.
Der Name des bestellten Store.
Der Name des Datenspeicherbereichs. Siehe Bereiche.
Der Name des Eintrags.
Anfrage
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ückmeldung
Erforderliche Berechtigungen
Die folgenden API-Schlüssel-Berechtigungen werden benötigt, um diesen Endpunkt aufzurufen. Für weitere Informationen zur Erzeugung korrekter Schlüssel siehe API-Schlüssel verwalten.
Abrufen
Holt und gibt den angegebenen Eintrag zurück.
Parameter
Die Identifikator des Erlebnisses mit bestellten Datenlagern, auf die Sie Zugriffmöchten.Siehe Universitäts-ID auf, wie sie auf Creator-Dashboard kopiert werden kann.
Der Name des bestellten Store.
Der Name des Datenspeicherbereichs. Siehe Bereiche.
Die Eintrags-ID.
Anfrage
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ückmeldung
Erforderliche Berechtigungen
Die folgenden API-Schlüssel-Berechtigungen werden benötigt, um diesen Endpunkt aufzurufen. Für weitere Informationen zur Erzeugung korrekter Schlüssel siehe API-Schlüssel verwalten.
Löschen
Löscht den angegebenen Eintrag.
Parameter
Die Identifikator des Erlebnisses mit bestellten Datenlagern, auf die Sie Zugriffmöchten.Siehe Universitäts-ID auf, wie sie auf Creator-Dashboard kopiert werden kann.
Der Name des bestellten Store.
Der Name des Datenspeicherbereichs. Siehe Bereiche.
Die Eintrags-ID.
Anfrage
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ückmeldung
Erforderliche Berechtigungen
Die folgenden API-Schlüssel-Berechtigungen werden benötigt, um diesen Endpunkt aufzurufen. Für weitere Informationen zur Erzeugung korrekter Schlüssel siehe API-Schlüssel verwalten.
Update
Aktualisiert einen Eintragswert und gibt den aktualisierten Eintrag zurück.
Parameter
Die Identifikator des Erlebnisses mit bestellten Datenlagern, auf die Sie Zugriffmöchten.Siehe Universitäts-ID auf, wie sie auf Creator-Dashboard kopiert werden kann.
Der Name des bestellten Store.
Der Name des Datenspeicherbereichs. Siehe Bereiche.
Die Eintrags-ID.
Die Flagge, um die Erstellung eines Eintrags zu ermöglichen, wenn der Eintrag nicht existiert. Siehe Fehlende Flags zulassen.
Anfrage
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ückmeldung
Erforderliche Berechtigungen
Die folgenden API-Schlüssel-Berechtigungen werden benötigt, um diesen Endpunkt aufzurufen. Für weitere Informationen zur Erzeugung korrekter Schlüssel siehe API-Schlüssel verwalten.
Zunahme
Erhöht den Wert des Schlüssels um den angegebenen Betrag und gibt den aktualisierten Eintrag zurück.
Bekanntes Problem: Eintrittswerte können über die gültige Reichweite hinaus zunehmen, und dies kann im Backend bestehen bleiben. Zurückgegebene Werte werden sich an die gültige Reichweite halten.
Parameter
Die Identifikator des Erlebnisses mit bestellten Datenlagern, auf die Sie Zugriffmöchten.Siehe Universitäts-ID auf, wie sie auf Creator-Dashboard kopiert werden kann.
Der Name des bestellten Store.
Der Name des Datenspeicherbereichs. Siehe Bereiche.
Die Eintrags-ID.
Anfrage
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ückmeldung
Erforderliche Berechtigungen
Die folgenden API-Schlüssel-Berechtigungen werden benötigt, um diesen Endpunkt aufzurufen. Für weitere Informationen zur Erzeugung korrekter Schlüssel siehe API-Schlüssel verwalten.
Objekte
Die folgenden Objekte beschreiben Nutzlasten, die akzeptiert oder zurückgegeben werden. Die einzelnen Endpunkte zeigen weitere Informationen darüber an, wann diese Objekte verwendet werden.
CreateEntryRequest
Erstellt einen neuen Eintrag mit dem angegebenen Wert.
Attribute
Der Wert, um den neuen Eintrag zu setzen.Wenn der Eingabewert den maximalen Wert von int64 überschreitet, der 9,223,372,036,854,775,807 beträgt, scheitert die Anfrage mit einem 400-Fehler "Bad Request".
Entry
Repräsentiert einen Eintrag.
Attribute
Der Name des Eintrags
Der Ressourcenpfad der Anfrage.
Der Wert des Eintrags.
IncrementEntryRequest
Erhöht den Eingabewert.
Attribute
Die Menge, die um den Eintragswert zu erhöhen.Wenn der Eingabewert den maximalen Wert von int64 überschreitet, der 9,223,372,036,854,775,807 beträgt, scheitert die Anfrage mit einem 400-Fehler "Bad Request".
ListEntriesResponse
Eine Liste von Einträgen in der übergeordneten Sammlungen.
Attribute
Die Einträge aus dem angegebenen Bereich.
Ein Token, das als page_token an einen Server gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld ausgelassen wird, gibt es keine nachfolgenden Seiten.
UpdateEntryRequest
Aktualisiert den Eintrag mit einem neuen Wert.
Attribute
Der Wert, um den Eintrag zu aktualisieren.Wenn der Eingabewert den maximalen Wert von int64 überschreitet, der 9,223,372,036,854,775,807 beträgt, scheitert die Anfrage mit einem 400-Fehler "Bad Request".