Get ingredient sponsored products for a recipe

Pobierz wszystkie sponsorowane produkty wyraźnie powiązane ze składnikami konkretnego przepisu. Kierując zapytanie do pojedynczego przepisu, możesz natychmiast ustalić, które markowe SKU powinny zostać natywnie umieszczone, gdy użytkownik przegląda dane danie. To idealne narzędzie do precyzyjnie dopasowanych czasowo emisji reklam handlowych. Przypadki użycia: KONTEKSTOWE UMIESZCZANIE PRODUKTÓW • Użytkownik przegląda przepis „Klasyczne tiramisu” → obok listy składników pojawia się „Mascarpone marki Y” jako sponsorowana sugestia. Wysoka konwersja w momencie największej gotowości do zakupu. RESTAURACJE — WSPÓŁPRACA Z DOSTAWCAMI • Restauracja pokazuje produkty dostawców obok składników przepisu w cyfrowym menu. Przychody reklamowe od dostawców. „KUP PRZEPIS” JEDNYM KLIKNIĘCIEM • Zasil przycisk „Dodaj wszystko do koszyka” sponsorowanymi SKU skonfigurowanymi w panelu administracyjnym. Dochodowy koszyk dopasowany do przepisu.

GET
/recipes/{recipeId}/sponsored-products/ingredients
Recipes
Nie są wymagane kredyty

Odpowiedź

200
application/json
object[]

IngredientSponsoredProductArray

object[]

IngredientSponsoredProduct

Składnik przepisu powiązany ze sponsorowanym produktem

object

recipeIngredientId

Unikalny identyfikator tego wpisu składnika

integer<int32>

recipeId

Identyfikator przepisu, do którego należy ten składnik

integer<int32>

name

Nazwa składnika wyświetlana użytkownikowi

string

quantity?

Ilość użytego składnika

number<double> | null

measureUnitId?

Identyfikator jednostki miary ilości; można go rozwiązać za pomocą GET /definitions/measure-units

integer<int32> | null

unitQuantity

Liczba jednostek sponsorowanego produktu

integer<int32>

priority

Pozycja rekomendacji tego produktu dla składnika, gdzie najniższa wartość oznacza najlepsze dopasowanie, a numeracja zaczyna się od 1. Zgodne z formatScore: wraz ze wzrostem priorytetu wynik nigdy nie rośnie, a produkty bez wyniku są umieszczane na końcu. Pozycje mogą pomijać wartości, ponieważ produkt, który nie ma danych w żądanym języku, jest pomijany w odpowiedzi.

integer<int16>

formatScore?

Wynik zgodności formatu od 0,01 do 100: procent kupowanej ilości, który przepis faktycznie wykorzystuje. Wartość 100 oznacza, że rozmiar opakowania dokładnie odpowiada wymaganej ilości, a 50 oznacza, że kupujesz dwa razy więcej, niż potrzebujesz. Produkty z takim samym wynikiem są równie zgodne pod względem formatu, więc do wyboru spośród nich użyj priorytetu — z wyjątkiem wartości 0,01, przy której skala osiąga limit i informuje jedynie, że opakowanie jest zdecydowanie za duże. Wartość null, gdy nie można ocenić zgodności: masa produktu jest nieznana, ilość składnika nie ma odpowiednika w gramach (np. do smaku) albo powiązanie powstało przed wprowadzeniem tego pola i nie zostało jeszcze ponownie obliczone. Objętości są traktowane jako 1 ml = 1 g.

number<double> | null

productId

Identyfikator sponsorowanego produktu

integer<int32>

shopProductId?

Identyfikator produktu właściwy dla danego sklepu

string | null

productName

Nazwa sponsorowanego produktu

string

brand

Marka sponsorowanego produktu

string

ean?

Kod kreskowy EAN produktu

string | null

format?

Format opakowania produktu

string | null

weightGrams?

Waga produktu w gramach

number<double> | null

imageUrl?

Adres URL obrazu produktu

string | null
401
application/json
object

Unauthorized

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
403
application/json
object

Forbidden

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
406
application/json
object

Not Acceptable

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
422
application/json
object

Unprocessable Entity

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
429
application/json
object

Too Many Requests (APIM)

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
500
application/json
object

Internal Server Error

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
502
application/json
object

Bad Gateway (APIM)

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
504
application/json
object

Gateway Timeout (APIM)

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string