Get suggestion sponsored products for a recipe

استرجع جميع الأدوات أو الاقترانات أو الاقتراحات المدعومة المرتبطة بوصفة محددة. يتيح لك ذلك إثراء صفحة تفاصيل الوصفة بعمليات بيع إضافية مستهدفة وعالية الجودة، مثل أجهزة المطبخ أو اقتراحات المشروبات المتوافقة، والمصممة بدقة للطبق الذي يشاهده المستخدم. حالات الاستخدام: البيع الإضافي لأدوات المطبخ • تعرض وصفة «يخنة اللحم البقري» قدراً هولندياً من الحديد الزهر مدعوماً أو سكين طاهٍ من علامة تجارية شريكة. توسيع السلة بما يتجاوز الطعام. اقترانات النبيذ والمشروبات • قسم «مثالي مع هذا الطبق» في صفحة الوصفة، يضم نبيذاً أو بيرة حرفية أو مشروبات غازية مدعومة. المطاعم — اقتراحات مكملة • تقترح القائمة الرقمية نبيذاً متوافقاً أو حلوى مثالية للطبق المحدد. بيع إضافي في سياقه. نمط الحياة والتقديم • اقتراحات مدعومة لأدوات المائدة والمناديل والديكورات ذات الطابع الخاص، مثل العشاء الرومانسي أو حفلات الشواء الصيفية.

GET
/recipes/{recipeId}/sponsored-products/suggestions
Recipes
التكلفة: 5 رصيد لكل وصفة
الحصول على مفتاح APIعرض الأسعار

Get ingredient sponsored products for a recipe

GET /recipes/{recipeId}/sponsored-products/ingredients

Browse recipes

POST /recipes/browse

الاستجابة

200
application/json
object[]

SuggestionSponsoredProductArray

object[]

SuggestionSponsoredProduct

اقتراح وصفة مرتبط بمنتج مدعوم

object

recipeToolId?

المعرّف الفريد لإدخال هذا الاقتراح

integer<int32>

recipeId?

معرّف الوصفة التي تنتمي إليها هذه الأداة

integer<int32>

name?

اسم العرض للأداة

string | null

priority?

ترتيب توصية هذا المنتج للاقتراح، حيث تكون القيمة الأقل هي أفضل تطابق، ويبدأ الترتيب من 1. قد تتخطى الترتيبات بعض القيم، لأن المنتج الذي لا تتوفر له بيانات باللغة المطلوبة يُستبعد من الاستجابة. لا تتضمن الاقتراحات أي كمية، ولذلك لا تحتوي على درجة توافق التنسيق: يعكس الترتيب مدى صلة المنتج بالكتالوج فقط.

integer<int16>

productId?

معرّف المنتج المدعوم

integer<int32>

shopProductId?

المعرّف الخاص بالمتجر للمنتج

string | null

productName?

اسم المنتج المدعوم

string | null

brand?

علامة المنتج المدعوم

string | null

ean?

الرمز الشريطي EAN للمنتج

string | null

format?

صيغة تغليف المنتج

string | null

netQuantityGrams?

الكمية الصافية للمنتج بالجرام، تُقرأ فقط من تنسيق العبوة الذي يعلنه التاجر (تُعامل الأحجام على أساس 1 مل = 1 جم)؛ تكون null عندما لا يذكر التنسيق وزنًا أو حجمًا

number<double> | null

weightGrams?

مهجور: استخدم netQuantityGrams، إذ يحتوي على القيمة نفسها

number<double> | null
401
application/json
object

غير مصرّح به

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
403
application/json
object

محظور

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
406
application/json
object

غير مقبول

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
422
application/json
object

كيان غير قابل للمعالجة

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
429
application/json
object

عدد كبير جدًا من الطلبات

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
500
application/json
object

خطأ داخلي في الخادم

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string

Get ingredient sponsored products for a recipe

GET /recipes/{recipeId}/sponsored-products/ingredients

Browse recipes

POST /recipes/browse