Cửa hàng dữ liệu đã đặt (Beta)
*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.
Trang này bao gồm tài liệu tham khảo cho việc làm việc với các cửa hàng dữ liệu đã được lưu. Để biết thêm thông tin về việc sử dụng API, hãy xem Làm việc với các yêu cầu API cho các cửa hàng dữ liệu và hướng dẫn sử dụng Lưu trữ dữ liệu.
OrderedDataStores
Danh sách
Trả lại một danh sách các hàng từ một cửa hàng dữ liệu đã được xếp hạng.
Tham Số
Nhận dạng của trải nghiệm với các cửa hàng dữ liệu đã được lưu trữ mà bạn muốn truy cập. Xem ID Universe trên cách sao chép nó trên Creator Dashboard .
Tên của cửa hàng dữ liệu đã đặt hàng.
Tên của phạm vi lưu trữ dữ liệu. Xem Scopes .
Số lượng tối đa các kết quả để trả lại. Dịch vụ có thể trả lại ít hơn giá trị này. Giá trị mặc định là 10 . Giá trị tối đa là 100 và bất kỳ lần nhập nào trên 100 đều bị ép thành 100 .
Một thẻ trang đã nhận được từ cuộc gọi trước đó List. Cung cấp này để lấy lại trang sau đó. Khi trả tiền, tất cả các tham số khác được cung cấp cho List phải khớp với cuộc gọi cung cấp thẻ trang.
Hướng liệt kí. Mặc định là thứ tự tăng dần. Nhập một desc tiền đuôi để xuống.
Phạm vi các giá trị chấm điểm của các mục để trả lại. Tham khảo Bộ lọc .
Yêu Cầu
curl --location 'https://apis.roblox.com/ordered-data-stores/v1/universes/<universeId>/orderedDataStores/<orderedDataStore>/scopes/<scope>/entries' \
--header 'x-api-key: <insert-api-key>'Phản Hồi
Tạo
Tạo một mục mới với giá trị nội dung được cung cấp.
Tham Số
Nhận dạng của trải nghiệm với các cửa hàng dữ liệu đã được lưu trữ mà bạn muốn truy cập. Xem ID Universe trên cách sao chép nó trên Creator Dashboard .
Tên của cửa hàng dữ liệu đã được yêu cầu.
Tên của phạm vi lưu trữ dữ liệu. Xem Scopes .
Tên của mục.
Tạo một mục mới với giá trị được cung cấp.
Yêu Cầu
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>
}'Phản Hồi
Lấy
Lấy và trả lại hàng đã định.
Tham Số
Nhận dạng của trải nghiệm với các cửa hàng dữ liệu đã được lưu trữ mà bạn muốn truy cập. Xem ID Universe trên cách sao chép nó trên Creator Dashboard .
Tên của cửa hàng dữ liệu đã được yêu cầu.
Tên của phạm vi lưu trữ dữ liệu. Xem Scopes .
ID nhập.
Yêu Cầu
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>'Phản Hồi
Xóa
Xóa mục đã được chỉ định.
Tham Số
Nhận dạng của trải nghiệm với các cửa hàng dữ liệu đã được lưu trữ mà bạn muốn truy cập. Xem ID Universe trên cách sao chép nó trên Creator Dashboard .
Tên của cửa hàng dữ liệu đã được yêu cầu.
Tên của phạm vi lưu trữ dữ liệu. Xem Scopes .
ID nhập.
Yêu Cầu
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>'Phản Hồi
Cập Nhật
Cập nhật giá trị một điều kiện và trả lại điều kiện đã cập nhật.
Tham Số
Nhận dạng của trải nghiệm với các cửa hàng dữ liệu đã được lưu trữ mà bạn muốn truy cập. Xem ID Universe trên cách sao chép nó trên Creator Dashboard .
Tên của cửa hàng dữ liệu đã được yêu cầu.
Tên của phạm vi lưu trữ dữ liệu. Xem Scopes .
ID nhập.
Cập nhật mục đã được cung cấp với giá trị mới.
Cờ để cho phép tạo một hồ sơ nếu hồ sơ đó không tồn tại. Xem cho phép các cờ thiếu .
Yêu Cầu
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>
}'Phản Hồi
Tăng
Tăng giá trị của chìa khóa bằng số lượng cung cấp và trả lại các thông tin đã cập nhật.
Vấn đề đã biết: Giá trị nhập có thể tăng trên giới hạn hợp lệ và nó có thể tồn tại trong hậu cần. Các giá trị đã trả lại sẽ kẹp vào giới hạn hợp lệ.
Tham Số
Nhận dạng của trải nghiệm với các cửa hàng dữ liệu đã được lưu trữ mà bạn muốn truy cập. Xem ID Universe trên cách sao chép nó trên Creator Dashboard .
Tên của cửa hàng dữ liệu đã được yêu cầu.
Tên của phạm vi lưu trữ dữ liệu. Xem Scopes .
ID nhập.
Tăng giá trị đầu vào.
Yêu Cầu
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>
}'Phản Hồi
Đối Tượng
Các đối tượng sau đây mô tả payload được chấp nhận hoặc bị trả về. Xem từng điểm cuối để biết thêm thông tin về thời điểm sử dụng các đối tượng này.
CreateEntryRequest
Tạo một mục mới với giá trị được cung cấp.
Thuộc Tính
Giá trị để cài đặt mới. Nếu giá trị nhập vượt quá giá trị tối đa được hỗ trợ bởi int64, which là 9,223,372,036,854,775,807, yêu cầu thất bại với một lỗi yêu cầu 400 Bad Request.
Entry
Đại diện cho một hàng.
Thuộc Tính
Tên của mục
Con đường tài nguyên của yêu cầu.
Giá trị của các thông số.
IncrementEntryRequest
Tăng giá trị đầu vào.
Thuộc Tính
Số tiền tăng lên bởi giá trị nhập. Nếu giá trị nhập vượt quá giá trị tối đa được hỗ trợ bởi int64, which là 9,223,372,036,854,775,807, yêu cầu thất bại với một lỗi yêu cầu 400 Bad Request.
ListEntriesResponse
Một danh sách các vị trí trong bộ sưu tậpmục cha.
Thuộc Tính
Các vị trí từ phạm vi được chỉ định.
Một token, which can be sent as page_token để lấy trang tiếp theo. Nếu trường này bị bỏ qua, không có trang tiếp theo.
UpdateEntryRequest
Cập nhật mục đã được cung cấp với giá trị mới.
Thuộc Tính
Giá trị để cập nhật hồ sơ. Nếu giá trị nhập vượt quá giá trị tối đa được hỗ trợ bởi int64, which là 9,223,372,036,854,775,807, yêu cầu thất bại với một lỗi yêu cầu 400 Bad Request.