Halaman referensi di bagian Open Cloud v2 dan Open Cloud v1 ditampilkan dari file JSON yang merupakan deskripsi OpenAPI.File-file ini menggunakan versi 3.0.4 dari spesifikasi OpenAPI.
File-file ini adalah sumber terbuka dan dapat digunakan dengan alat seperti Editor Swagger dan Postman untuk menguji panggilan API dan membantu mengotomatisasi pengembangan.
Deskripsi OpenAPI ini masih dalam pengembangan aktif dan mungkin berisi masalah.Halaman di bawah bagian Sumber daya adalah referensi resmi.
File deskripsi API terbuka
File deskripsi OpenAPI tersedia di lokasi berikut dalam repositori dokumen pencipta:
# All V2 Resourceshttps://github.com/Roblox/creator-docs/blob/main/content/en-us/reference/cloud/cloud.docs.json# V1 Assetshttps://github.com/Roblox/creator-docs/blob/main/content/en-us/reference/cloud/assets/v1.json# V1 Ordered Data Storeshttps://github.com/Roblox/creator-docs/blob/main/content/en-us/reference/cloud/datastores-api/ordered-v1.json# V1 Standard Data Storeshttps://github.com/Roblox/creator-docs/blob/main/content/en-us/reference/cloud/datastores-api/v1.json# V1 Messaginghttps://github.com/Roblox/creator-docs/blob/main/content/en-us/reference/cloud/messaging-service/v1.json# V1 Universeshttps://github.com/Roblox/creator-docs/blob/main/content/en-us/reference/cloud/universes-api/v1.json
Ekstensi penjual
Roblox menggunakan ekstensi spesifikasi untuk memperluas spesifikasi OpenAPI untuk memperluas spesifikasi OpenAPI.Ekstensi ini mewakili informasi yang spesifikasi tidak menangkap secara default.Ekstensi dapat muncul di seluruh file di mana diizinkan oleh spesifikasi OpenAPI.
Mayoritas ekstensi spesifikasi ini adalah eksperimental.Ekstensi yang digunakan bersifat dapat berubah tanpa pemberitahuan demi bidang yang ditemukan dalam spesifikasi OpenAPI resmi.
Ekstensi spesifikasi sumber daya V2
Ekstensi | Lokasi | Deskripsi |
---|---|---|
x-categories | Objek OpenAPI | Daftar string.Semua kategori sumber daya. |
x-visibility | Objek Operasi | Boolean.Keterlihatan operasi. |
x-roblox-docs | Objek Operasi | Objek.Hubungkan operasi dengan kategori dan sumber daya. |
x-long-running-operation-parameters | Objek Operasi | Objek.Referensikan metadata dan respons untuk respons jangka panjang operasi. |
x-aep-resource | Objek Skema | Objek.Ekstensi yang mencatat ketiksumber daya.Memiliki kompatibilitas dekat dengan AEP-4 , salah satu proposal Peningkatan API. |
x-oneOf | Objek Skema | Objek.Setiap bidang berisi daftar properti dalam skema.Hanya satu dari properti harus hadir. |
x-resource | Objek Skema | Boolean.Apakah skema adalah sumber daya. |
x-immutable | Objek Skema | Boolean.Apakah skema tidak dapat diubah. |
Ekstensi spesifikasi sumber daya V1
Ekstensi | Lokasi | Deskripsi |
---|---|---|
x-roblox-cloud-api-operation | Operasi Objek | Boolean.Apakah operasi adalah operasi Cloud Terbuka. |
x-roblox-cloud-api-operation-name | Objek Operasi | String.Nama operasi. |
x-roblox-cloud-api-operation-code-samples | Objek Operasi | Objek.Daftar sampel kode, objek dengan bahasa/judul dan skrip yang sesuai. |
x-roblox-cloud-api-operation-throttling-limit | Objek Operasi | Objek.Batas pengurangan untuk operasi. |