Varlık API'si
*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.
Roblox'ta varlıklar oluşturmak için aşağıdaki istek ve yanıt yüklerini gönderebilir ve alabilirsiniz.API'nin kullanımıyla ilgili bilgi için, kullanım kılavuzu'na bakın.
Assets
Varlık Sürümlerini Listele
Belirli bir varlığın tüm sürümlerini, isteğe bağlı sayfa numaralama ile listeleyin.
Parametreler
Varlığın benzersiz tanımlayıcısı.
Yanıta dahil edilecek varlık sürümlerinin sayısını belirtir. Geçerli değerler 1 ila 50 (dahil) arasındadır. Verilmediğinde varsayılan değer 8'dir.
Sayfa numaralandırması için bir jeton. Değer önceki bir istekte alınır ve varlık sürümlerinin bir sonraki sayfasının alınmasına izin verir.
Talep
curl --location 'https://apis.roblox.com/assets/v1/assets/{assetid}/versions?pageToken=&maxPageSize=' \
--header 'x-api-key: {apiKey}'
Yanıt
Gerekli İzinler
Bu uç noktasının çağrılması için aşağıdaki API anahtarı izinleri gerekir. Doğru anahtar üretimi hakkında daha fazla bilgi için API anahtarlarını yönet sayfasını incele.
Sınırlar
API Anahtarı başına: Her 60 saniyede IP adresi başına 100 talep
Geri Yüklenen Varyant Versiyonu
Bir varlığı belirli bir önceki sürüme geri al.
Form verilerinde varlık sürüm yolunu sağlayın.
Parametreler
Varlığın benzersiz tanımlayıcısı.
Talep
curl --location 'https://apis.roblox.com/assets/v1/assets/{assetid}/versions:rollback' \
--header 'x-api-key: {apiKey}' \
--header 'Content-Type: application/json' \
--data '{\"assetVersion\":\"assets/{assetId}/versions/{versionNumber}\"}'
Yanıt
Gerekli İzinler
Bu uç noktasının çağrılması için aşağıdaki API anahtarı izinleri gerekir. Doğru anahtar üretimi hakkında daha fazla bilgi için API anahtarlarını yönet sayfasını incele.
Sınırlar
API Anahtarı başına: Her 60 saniyede IP adresi başına 100 talep
Varlık Oluştur
Verilen içerik ve metadatarla bir varlık oluşturur.
Bir varlık oluştururken Sosyal Bağlantı nesnelerini ekleyemezsiniz. Bunun yerine Varlığı Güncelle kullanın.
Varlık, ikili dosya yolunu ve içerik türü form verilerinde sağlayın.
Talep
curl --location --request POST 'https://apis.roblox.com/assets/v1/assets' \
--header 'x-api-key: {apiKey}' \
--form 'request="{
\"assetType\": \"Model\",
\"displayName\": \"Name\",
\"description\": \"This is a description\",
\"creationContext\": {
\"creator\": {
\"userId\": \"${userId}\"
}
}
}"' \
--form 'fileContent=@"/filepath/model.fbx";type=model/fbx'
Yanıt
Gerekli İzinler
Bu uç noktasının çağrılması için aşağıdaki API anahtarı izinleri gerekir. Doğru anahtar üretimi hakkında daha fazla bilgi için API anahtarlarını yönet sayfasını incele.
Sınırlar
API Anahtarı başına: Her 60 saniyede IP adresi başına 60 talep
Varlığı Al
Belirli varlık içeriğini ve metadatlarını geri al.
Parametreler
Varlığın benzersiz tanımlayıcısı.
Açıklama, görünen ad, simge, sosyal bağlantılar ve önizlemeler dahil olmak üzere alınacak varlık açıklama alanları. Örnekler: description%2CdisplayName , previews%2CtwitchSocialLink .
Talep
curl --location --request GET 'https://apis.roblox.com/assets/v1/assets/{assetId}' \
--header 'x-api-key: {apiKey}'
curl --location --request GET 'https://apis.roblox.com/assets/v1/assets/{assetId}?readMask={read_mask}' \
--header 'x-api-key: {apiKey}'
Yanıt
Gerekli İzinler
Bu uç noktasının çağrılması için aşağıdaki API anahtarı izinleri gerekir. Doğru anahtar üretimi hakkında daha fazla bilgi için API anahtarlarını yönet sayfasını incele.
Sınırlar
API Anahtarı başına: Her 60 saniyede IP adresi başına 60 talep
Varlığı Güncelle
Açıklama, görünen ad, simge, sosyal bağlantılar ve önizlemeler dahil olmak üzere bir varlığı sağlanan içerik ve metadatayla günceller.Şu anda sadece Modeller için içerik gövdesini güncelleyebilir.Simgeler ve Önizlemeler Resim öğeleri olmalıdır.Simgelerin kare boyutları olması gerekir.
Varlık, ikili dosya yolunu ve içerik türü form verilerinde sağlayın.
Parametreler
Varlığın benzersiz tanımlayıcısı.
açıklama, görünen ad, simge ve önizlemeler dahil olmak üzere güncellenmesi gereken varlık öznitelik alanları. Örnekler: description%2CdisplayName , previews%2CtwitchSocialLink .
Talep
curl --location --request PATCH 'https://apis.roblox.com/assets/v1/assets/{assetId}' \
--header 'x-api-key: {apiKey}' \
--form 'request="{\"assetId\": {assetId} }"' \
--form 'fileContent="@\"{file-path}\""'
curl --location --request PATCH 'https://apis.roblox.com/assets/v1/assets/{assetId}?updateMask=description%2CdisplayName' \
--header 'x-api-key: {apiKey}' \
--form 'request="{
\"assetType\": \"{assetType}\",
\"assetId\": {assetId},
\"displayName\": \"{new display name}\",
\"description\": \"{new description}\",
\"creationContext\": {
\"creator\": {
\"userId\": {userId}
},
\"expectedPrice\":{expectedPrice}
},
}"' \
--form 'fileContent=@\"{file-path}\"'
curl --location --request PATCH 'https://apis.roblox.com/assets/v1/assets/{assetId}?updateMask=previews' \
--header 'x-api-key: {apiKey}' \
--form 'request="{\"assetId\": \"{assetId}\", \"previews\": [{\"asset\": \"assets/123\", \"altText\": \"Your alt text.\"}]}"'
curl --location --request PATCH 'https://apis.roblox.com/assets/v1/assets/{assetId}?updateMask=twitchSocialLink%2CgithubSocialLink' \
--header 'x-api-key: {apiKey}' \
--form 'request="{\"assetId\": \"{assetId}\", \"twitchSocialLink\": {\"title\": \"Optional title\", \"uri\": \"https://twitch.tv/your-channel\"}, \"githubSocialLink\": {\"title\": \"Optional title\", \"uri\": \"https://github.com/your-repo\"}}"'
Yanıt
Gerekli İzinler
Bu uç noktasının çağrılması için aşağıdaki API anahtarı izinleri gerekir. Doğru anahtar üretimi hakkında daha fazla bilgi için API anahtarlarını yönet sayfasını incele.
Sınırlar
API Anahtarı başına: Her 60 saniyede IP adresi başına 60 talep
Varlık Sürümünü Al
Varlık kimliği ve sürüm numarası ile belirli bir varlık sürümünü al.
Parametreler
Varlığın benzersiz tanımlayıcısı.
Sürüm numarası.
Talep
curl --location 'https://apis.roblox.com/assets/v1/assets/{assetId}/versions/{versionNumber}' \
--header 'x-api-key: {apiKey}'
Yanıt
Gerekli İzinler
Bu uç noktasının çağrılması için aşağıdaki API anahtarı izinleri gerekir. Doğru anahtar üretimi hakkında daha fazla bilgi için API anahtarlarını yönet sayfasını incele.
Sınırlar
API Anahtarı başına: Her 60 saniyede IP adresi başına 100 talep
Arşiv Varlığı
Kaynağı arşivler.Arşivlenmiş varlıklar web sitesinden kaybolur ve artık Roblox deneyimlerinde kullanılamaz veya görünemez, ancak onları geri yükleyebilirsiniz.
Parametreler
Varlığın benzersiz tanımlayıcısı.
Talep
curl --location 'https://apis.roblox.com/assets/v1/assets/{assetid}:archive' \
--header 'x-api-key: {apiKey}' \
--header 'Content-Type: application/json'
Yanıt
Gerekli İzinler
Bu uç noktasının çağrılması için aşağıdaki API anahtarı izinleri gerekir. Doğru anahtar üretimi hakkında daha fazla bilgi için API anahtarlarını yönet sayfasını incele.
Sınırlar
API Anahtarı başına: Her 60 saniyede IP adresi başına 100 talep
Varlığı Geri Yükle
Arşivlenmiş bir varlığı yeniler.
Parametreler
Varlığın benzersiz tanımlayıcısı.
Talep
curl --location 'https://apis.roblox.com/assets/v1/assets/{assetid}:restore' \
--header 'x-api-key: {apiKey}' \
--header 'Content-Type: application/json'
Yanıt
Gerekli İzinler
Bu uç noktasının çağrılması için aşağıdaki API anahtarı izinleri gerekir. Doğru anahtar üretimi hakkında daha fazla bilgi için API anahtarlarını yönet sayfasını incele.
Sınırlar
API Anahtarı başına: Her 60 saniyede IP adresi başına 100 talep
Operasyonu Alın
Döndürülen Operasyon Kimliğini kullanarak bir varlık oluşturma veya güncelleme sonucunu alın.API anahtar izni için Oku ve OAuth 2.0 uygulamaları için varlık:oku gerekir.
Parametreler
Operasyonun benzersiz tanımlayıcısı.
Talep
curl --location 'https://apis.roblox.com/assets/v1/operations/{operationId}' \
--header 'x-api-key: {apiKey}'
Yanıt
Gerekli İzinler
Bu uç noktasının çağrılması için aşağıdaki API anahtarı izinleri gerekir. Doğru anahtar üretimi hakkında daha fazla bilgi için API anahtarlarını yönet sayfasını incele.
Sınırlar
API Anahtarı başına: Her 60 saniyede IP adresi başına 100 talep
Nesneler
Şu nesneler kabul edilen veya döndürülen yükleri tanımlar. Bu nesnelerin ne zaman kullanıldığı hakkında daha fazla bilgi için tüm uç noktalara bak.
Any
Seri hale getirilmiş mesajın türünü tanımlayan bir @type ile rastgele seri hale getirilmiş bir mesaj içerir.
Nitelikler
Serilmiş mesajın türü.
Asset
Bir varlığı temsil eder.
Nitelikler
Varlığın benzersiz tanımlayıcısı. Varlığı güncelle için gereklidir.
Varlık yaz. Sadece Audio , Decal veya Model olabilir. Varlık Oluşturma için gerekli.
Metadat ve yaratıcı bilgileri gibi varlık içeriğinin bir parçası olmayan yaratımın konteksi. Varlık oluşturma için gereklidir.
Varlığın açıklaması. 1000 karaktere kadar sınırlandırın. Varlık oluşturma için gereklidir.
Varlığın görünen adı. Varlık oluşturma için gereklidir.
simgekaynak yolu.
Varlığın moderasyon sonucu.
Varlığın geri dönen kaynak yolu. Biçim: assets/{assetId} . Örnek: assets/2205400862 .
Önizlemelerin bir listesi, her biri bir varlık yolu ve alt metin ile. Önizlemeler Resim varlıkları olmalıdır.
Mevcut revizyonun oluşturulma zamanı.
Varlığın revizyon kimliği.versionNumber eşdeğer.Varlığın her değişikliği otomatik olarak yeni bir sürüm işaret eder.Format bir tamsayısal dizi.Örnek: 1 .
Varlık için bir sosyal medya bağlantısı.Her bir varlık için maksimum üç.Nesne adı herhangi biri olabilir:
- facebookSocialLink
- twitterSocialLink
- youtubeSocialLink >
- twitchSocialLink >
- discordSocialLink >
- githubSocialLink >
- robloxSocialLink >
- guildedSocialLink >
- devForumSocialLink > >
Varlık aktif veya arşivli olup olmadığı. Belirtilmeyen kullanılmaz.
AssetVersion
Bir varlık versiyonu.
Nitelikler
Metadat ve yaratıcı bilgileri gibi varlık içeriğinin bir parçası olmayan yaratımın konteksi. Varlık oluşturma için gereklidir.
Varlığın moderasyon sonucu.
Varlık sürümünün döndürülen kaynak yolu. Biçim: assets/{assetId}/versions/{version} . Örnek: assets/2205400862/versions/1 .
CreationContext
Metadat ve yaratıcı bilgileri gibi varlık içeriğinin bir parçası olmayan yaratımın konteksi. Varlık oluşturma için gereklidir.
Nitelikler
Bir yaratıcıyı temsil eder.
Robux'ta beklenen varlık yükleme ücreti. Gerçek fiyat beklenenden daha fazla olduğunda, işlem 400 hatasıyla başarısız olur.
Creator
Bir yaratıcıyı temsil eder.
Nitelikler
Grup Kimliği. Varlık grup tarafından sahipleniyorsa gerekli.
yaratıcıKullanıcı Kimliği. Varlık bireysel kullanıcıya aitse gereklidir.
ModerationResult
Varlığın moderasyon sonucu.
Nitelikler
Varlığın moderasyon durumu. Reviewing , Rejected veya Approved olabilir.
Operation
Bu kaynak, bir ağ API çağrısının sonucu olan uzun süren bir operasyonu temsil eder.
Nitelikler
Eğer false , operasyon hala devam ediyorsa. Eğer true , operasyon tamamlanır.
Hata durumunu açıklayan mantıksal hata modeli.
Seri hale getirilmiş mesajın türünü tanımlayan bir @type ile rastgele seri hale getirilmiş bir mesaj içerir.
Sunucu tarafından atanan kaynak yolu. Varsayılan format operations/{operation_id} dir.
Seri hale getirilmiş mesajın türünü tanımlayan bir @type ile rastgele seri hale getirilmiş bir mesaj içerir.
Preview
Bir varlık önizlemesi.
Nitelikler
Önizleme varlığı için alternatif metin.
Önizleme varlık yolu.
SocialLink
Varlık için bir sosyal medya bağlantısı.Her bir varlık için maksimum üç.Nesne adı herhangi biri olabilir:
- facebookSocialLink
- twitterSocialLink
- youtubeSocialLink >
- twitchSocialLink >
- discordSocialLink >
- githubSocialLink >
- robloxSocialLink >
- guildedSocialLink >
- devForumSocialLink > >
Nitelikler
Sosyal medya bağlantısı için opcional bir başlık. Yaratıcı Merkez'de kullanılmaz.
Sosyal medya bağlantısı için URI.Bağlantı türü için beklenen biçime uymalıdır.Örneğin, bir twitchSocialLink nesnesinin başlığı formatına sahip olmalıdır https://twitch.tv/your-channel .
State
Varlık aktif veya arşivli olup olmadığı. Belirtilmeyen kullanılmaz.
Nitelikler
Status
Hata durumunu açıklayan mantıksal hata modeli.
Nitelikler
HTTP durum kodu.
Hata ayrıntıları taşıyan bir mesaj listesi.
Hata mesajı.