استعلامات متجر المبدعين | المراجع

يمكنك البحث عن أصول Roblox خارج الاستوديو من خلال الوصول إلى واجهة برمجة تطبيقات متجر المبدعين. استخدم واجهة برمجة تطبيقات متجر المبدعين للاستعلام عن أصول الاستوديو، مثل الشبكات والنماذج والصوت، وواجهة برمجة تطبيقات السوق للاستعلام عن أصول الصور الرمزية في السوق.

تتطلب كل واجهة برمجة تطبيقات عنوان URL ومعلمات بحث مخصصة لذلك الكتالوج المحدد. إذا كان كل من عنوان URL والمعلمات صالحين، ترجع واجهة برمجة التطبيقات تنسيق JSON مع نتائج بحثك.

واجهة برمجة تطبيقات متجر المبدعين

للحصول على معلومات حول إجراء المكالمات إلى واجهة برمجة تطبيقات متجر المبدعين للبحث، راجع خدمة Toolbox في مرجع Open Cloud.

واجهة برمجة تطبيقات السوق

يمكنك الاستعلام عن عناصر الصور الرمزية من السوق باستخدام عنوان URL التالي: https://catalog.roblox.com/v1/search/items/details?[params]

يمكنك استبدال [params] بمعلمات الاستعلام المناسبة لتخصيص بحثك.

معلمات الاستعلام

يمكنك تحديد معلمات البحث من خلال إلحاق مجموعة من المعلمات والقيم إلى عنوان URL، يفصل بينها كل منها بـ &.

استخدم المعلمات التالية للاستعلام عن السوق:

المعلمة	النوع	الخيارات والقيم
الفئة	بايت	0 = مميز 1 = الكل 2 = المقتنيات 3 = الملابس 4 = أجزاء الجسم 5 = المعدات 11 = الملحقات 12 = رسومات الصورة الرمزية 13 = إبداعات المجتمع
نوع المنشئ	بايت	1 = مستخدم 2 = مجموعة تتطلب الاستعلامات التي تستخدم نوع المنشئ أيضا معلمة معرف_المنشئ.
معرف المنشئ المستهدف	طويل	معرف المستخدم أو المجموعة بناءً على نوع المنشئ المقدم. تتطلب الاستعلامات التي تستخدم معرف المنشئ المستهدف أيضا معلمة نوع المنشئ.
اسم المنشئ	سلسلة	البحث حسب اسم المنشئ. إذا لم يتم توفير Enum.CreatorType، يكون البحث للمستخدمين فقط.
المؤشر	سلسلة	تحتوي كل استجابة بحث على nextPageCursor إذا كان هناك صفحة تالية وpreviousPageCursor إذا كان هناك صفحة سابقة. مرر إما من هذه القيم في معلمة المؤشر لاستعلامك التالي للحصول على الصفحة التالية أو السابقة من النتائج. يكون المؤشر صالحًا إذا ظلت باقي معلمات الاستعلام كما هي.
الأنواع	بايت	يحدد النوع للبحث. الطريقة الموصى بها لتصفية الأنواع هي مطابقة عنوان URL لصفحة كتالوج. 1 = المدينة والريف 2 = القرون الوسطى 3 = الخيال العلمي 4 = القتال 5 = الرعب 6 = البحرية 7 = المغامرة 8 = الرياضة 9 = الكوميديا 10 = الغربي 11 = العسكرية 13 = البناء 14 = FPS 15 = RPG
الكلمة المفتاحية	سلسلة	بحث بكلمة مفتاحية قياسية.
الحد الأقصى	عدد صحيح	عدد النتائج التي سيتم إرجاعها. القيم محدودة حاليًا إلى 10 و 28 و 30.
أعلى سعر	عدد صحيح	أعلى سعر بالروبكس للعناصر في الاستعلام.
أدنى سعر	عدد صحيح	أدنى سعر بالروبكس للعناصر في الاستعلام.
ترتيب التجميع	بايت	1 = اليوم الماضي 3 = الأسبوع الماضي 4 = الشهر الماضي 5 = على الإطلاق
نوع الترتيب	بايت	0 = الأهمية ( الافتراضي) 1 = المفضلة 2 = المبيعات 3 = المحدثة 4 = السعر تصاعديًا 5 = السعر تنازليًا
الفئة الفرعية	بايت	0 = مميز 1 = الكل 2 = المقتنيات 3 = الملابس 4 = أجزاء الجسم 5 = المعدات 9 = القبعات 10 = الوجوه 12 = القمصان 13 = القمصان القطنية 14 = البنطلونات 15 = الرؤوس 19 = الملحقات 20 = ملحقات الشعر 21 = ملحقات الوجه 22 = ملحقات الرقبة 23 = ملحقات الكتف 24 = ملحقات المقدمة 25 = ملحقات الظهر 26 = ملحقات الخصر 27 = رسومات الصورة الرمزية 37 = الحزم 38 = حزم الرسوم المتحركة 39 = حزم الحركات 40 = إبداعات المجتمع 41 = القتالية 42 = بعيدة المدى 43 = المتفجرات 44 = تعزيز 45 = التنقل 46 = موسيقي 47 = اجتماعي 48 = بناء 49 = نقل 54 = ملحقات الرأس 55 = القمصان القطنية الكلاسيكية 56 = القمصان الكلاسيكية 57 = البنطلونات الكلاسيكية 58 = ملحقات القمصان القطنية 59 = ملحقات القمصان 60 = ملحقات البنطلونات 61 = ملحقات السترات 62 = ملحقات السويتر 63 = ملحقات الشورتات 64 = حزم الأحذية 65 = ملحقات التنورة 66 = الرؤوس الديناميكية

سيقوم عنوان URL التالي بالبحث عن أول 10 عناصر "معدات" في "الملحقات" مرتبة حسب الزمن ("ترتيب التجميع") والأهمية ("نوع الترتيب") التي أنشأتها Roblox ("معرف المنشئ المستهدف" و"نوع المنشئ"):

https://catalog.roblox.com/v1/search/items/details?Category=11&Subcategory=5&CreatorTargetId=1&CreatorType=User&SortType=0&SortAggregation=5&Limit=10

حقول الاستجابة

ترجع استجابات واجهة برمجة التطبيقات بتنسيق JSON. توفر الاستجابة تفاصيل الأصل في مفتاح data باستخدام الحقول التالية:

الحقل	الوصف
نوع الأصل	واحد من قيم نوع الأصل التالية (تُرجع فقط إذا كانت العنصر أصلًا). 2 = T-Shirt 8 = Hat 11 = Shirt 12 = Pants 17 = Head 18 = Face 19 = Gear 25 = Arms 26 = Legs 27 = Torso 28 = RightArm 29 = LeftArm 30 = LeftLeg 31 = RightLeg 41 = HairAccessory 42 = FaceAccessory 43 = NeckAccessory 44 = ShoulderAccessory 45 = FrontAccessory 46 = BackAccessory 47 = WaistAccessory 48 = ClimbAnimation 49 = DeathAnimation 50 = FallAnimation 51 = IdleAnimation 52 = JumpAnimation 53 = RunAnimation 54 = SwimAnimation 55 = WalkAnimation 56 = PoseAnimation 61 = EmoteAnimation
نوع الحزمة	معرف نوع الحزمة (تُرجع فقط إذا كانت العنصر حزمة). القيم الممكنة هي أجزاء الجسم ورسومات الصورة الرمزية.
اسم المنشئ	اسم المنشئ.
معرف المنشئ المستهدف	معرف المنشئ.
نوع المنشئ	نوع منشئ العنصر.
الوصف	وصف العنصر.
عدد المفضلين	عدد المفضلين لعنصر معين.
الأنواع	قائمة أنواع العنصر. تشمل القيم الممكنة الكل، التعليمات، الرعب، المدينة والريف، الحرب، الكوميديا، الخيال، المغامرة، الخيال العلمي، قرصان، FPS، RPG، الرياضة، نينجا، والغرب المتوحش.
المعرف	معرف العنصر.
قيود العنصر	قائمة قيود العنصر. القيم الممكنة هي ثلاثة عشر فما فوق، محدود فريد، محدود، وRthro.
حالة العنصر	قائمة علامات حالة العنصر. القيم الممكنة هي جديد، للبيع، حصري لعائلة إكس بوكس، حصري لأمازون، حصري لـGoogle Play، حصري لـIos، وعداد البيع.
نوع العنصر	نوع العنصر. القيم الممكنة هي أصل أو حزمة.
أدنى سعر	أدنى سعر إعادة بيع للعنصر (تُرجع فقط إذا كان العنصر قابلًا لإعادة البيع).
الاسم	اسم العنصر.
السعر	سعر عرض العنصر (قد يختلف السعر الحالي إذا كان العنصر قابلاً لإعادة البيع).
حالة السعر	حالة سعر عنصر لا يتم بيعه. القيم الممكنة هي مجاني، غير معروض للبيع، أو لا توجد بائعيين.
عدد المشتريات	عدد مشتريات عنصر معين.
وحدات متاحة للاستهلاك	الوحدات المتاحة للاستهلاك من عنصر فريد محدود.

فيما يلي مثال على مخرجات الإرجاع المتوقعة لعنصر واحد:


{
	"keyword": null,
	"previousPageCursor": null,
	"nextPageCursor": "2_1_c541d05046b5c1c78a5d386b5e302243",
	"data": [
    {
        "id":527373900,
        "itemType":
        "أصل",
        "assetType":42,
        "name":"رباط الأرواح القلقة",
        "description":"هذا الرباط لن يساعدك على الاندماج مع الأشباح، لكنه على الأقل سيجعلك أنيقًا.",
        "productId":41270974,
        "genres":[
          "الرعب",
          "المغامرة"
          ],
        "itemStatus":[],
        "itemRestrictions":[],
        "creatorType":"مستخدم",
        "creatorTargetId":1,
        "creatorName":"Roblox",
        "price":300,
        "favoriteCount":15943,
        "offSaleDeadline":null
        }
	]
}