Vzorové požadavky rozhraní API
Tento článek ukazuje některé příklady požadavků API a souvisejících odpovědí. Každý příklad ukazuje základní scénář doporučení spolu s dalšími funkcemi úpravy reakce, jako je filtrování, stránkování, výběr alternativního algoritmu a další. Chcete-li tyto příklady vyzkoušet na svém koncovém bodu Intelligent Recommendations, nezapomeňte nahradit název koncového bodu (část DNS) a upravit parametry podle svých dat.
Poznámka:
Parametr počet bude řídit počet položek vrácených v každé odpovědi. Příklady budou mít počet nastaven na 5 kvůli jasnosti a stručnosti. Další informace o způsobech vytváření požadavků na rozhraní API najdete v části Rozhraní API pro Intelligent Recommendations a Příručka pro rychlý start pro volání rozhraní API.
Příklady
Zde je několik příkladů, které můžete otestovat pomocí účtu Intelligent Recommendations:
- Načtení nových položek
- Načtení oblíbených položek
- Načtení podobných položek
- Načtení výběru pro uživatele
- Další nejlepší akce (košík)
- Označování metadat a sdružování uživatelů
- Jak používat parametr AlgoType
- Jak používat parametr vylepšení
- Stavové kódy API
Pokud při testování odpovědí narazíte na chyby, přečtěte si část Protokoly chyb.
Načtení nových položek
Rozhraní API pro nové položky vrátí seznam produktů seřazených podle data vydání.
Požadavek rozhraní API vypadá takto:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/New?modeling=adw&Count=5
Úspěšná odpověď vypadá takto:
{
"id": "Lists",
"name": "Lists",
"version": "v1.0",
"interactionsVersion": "20220104115104",
"items": [
{
"id": "70000",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "70002",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "70003",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "70004",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "70005",
"trackingId": "00000000-0000-0000-0000-000000000003"
}
],
"title": "New",
"longTitle": "New",
"titleId": 3,
"pagingInfo": {
"totalItems": 278
},
"status": "Success"
}
Načtení nových položek a přeskočeních prvních 3
Položky v seznamu můžete přeskočit tak, že k požadavku přidáte „SkipItems“.
Požadavek rozhraní API vypadá takto:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/New?modeling=adw&Count=5&SkipItems=3
Úspěšná odpověď vypadá takto:
{
"id": "Lists",
"name": "Lists",
"version": "v1.0",
"interactionsVersion": "20220104115104",
"items": [
{
"id": "70004",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "70005",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "70006",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "66001",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "66002",
"trackingId": "00000000-0000-0000-0000-000000000003"
}
],
"title": "New",
"longTitle": "New",
"titleId": 3,
"pagingInfo": {
"totalItems": 278
},
"status": "Success"
}
Načtení oblíbených položek
Rozhraní API pro načtení oblíbených položek vrací seznam položek seřazených podle počtu interakcí, jako je transakce, nákup, zobrazení, výběr nebo stažení. Ať už interakce uživatele a položky ve vaší firmě znamená cokoli, první položka v seznamu je ta, která má nejvíce interakcí, a ostatní jsou seřazeny v sestupném pořadí.
Požadavek rozhraní API vypadá takto:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Popular?modeling=adw&Count=5
Úspěšná odpověď vypadá takto:
{
"id": "Lists",
"name": "Lists",
"version": "v1.0",
"interactionsVersion": "20220104115104",
"items": [
{
"id": "65106",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "62604",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "70006",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "63503",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "62452",
"trackingId": "00000000-0000-0000-0000-000000000003"
}
],
"title": "Popular",
"longTitle": "Popular",
"titleId": 5,
"pagingInfo": {
"totalItems": 278
},
"status": "Success"
}
Načtení oblíbených položky v konkrétní kategorii
Kategorie můžete definovat v rámci datové entity ItemCategories. Další informace získáte v části Přehled datové smlouvy.
Požadavek API při vyhledávání nejoblíbenějších oděvů vypadá takto:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Popular?modeling=adw&Count=5&Category=Clothing
Úspěšná odpověď vypadá takto:
{
"id": "Lists",
"name": "Lists",
"version": "v1.0",
"interactionsVersion": "20220104115104",
"items": [
{
"id": "62604",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "62452",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "62502",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "62606",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "63402",
"trackingId": "00000000-0000-0000-0000-000000000003"
}
],
"title": "Popular",
"longTitle": "Popular",
"titleId": 5,
"pagingInfo": {
"totalItems": 95
},
"status": "Success"
}
Načtení oblíbených položek v konkrétní kategorii pomocí diskrétního filtru
Filtry můžete definovat v rámci datové entity ItemAndVariantFilters. Další informace získáte v části Přehled datové smlouvy.
Požadavek rozhraní API vypadá takto:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Popular?modeling=adw&Count=5&Category=Clothing&Size=S
Úspěšná odpověď vypadá takto:
{
"id": "Lists",
"name": "Lists",
"version": "v1.0",
"interactionsVersion": "20220104115104",
"items": [
{
"id": "61453",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "62104",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "62100",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "62103",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "61406",
"trackingId": "00000000-0000-0000-0000-000000000003"
}
],
"title": "Popular",
"longTitle": "Popular",
"titleId": 5,
"pagingInfo": {
"totalItems": 32
},
"status": "Success"
}
Načtení oblíbených položek v konkrétní kategorii při filtrování podle rozsahu hodnot
Další informace o syntaxi filtrování podle rozsahu naleznete v průvodci filtry rozsahu.
Požadavek rozhraní API vypadá takto:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Popular?modeling=adw&Count=10&Category=Clothing&$filter=rating gt 2 and rating lt 5
Úspěšná odpověď vypadá takto:
{
"id": "Lists",
"name": "Lists",
"version": "v1.0",
"interactionsVersion": "20220104115104",
"items": [
{
"id": "62604",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "62452",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "62502",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "62507",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "62106",
"trackingId": "00000000-0000-0000-0000-000000000003"
}
],
"title": "Popular",
"longTitle": "Popular",
"titleId": 5,
"pagingInfo": {
"totalItems": 5
},
"status": "Success"
}
Načtení podobných položek
Rozhraní API pro podobné položky poskytuje kontextová doporučení založená na konkrétních výchozích položkách. Vybraná položka je stěžejním bodem, na kterém budou založeny návrhy produktů. Požadavek rozhraní API zadaný pro číslo vybrané položky ihned následuje po Podobné/. Například vybraná položka pruhovaného svetru má jiné návrhy produktů ve srovnání s pánským sakem.
Požadavek rozhraní API vypadá takto:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Similar/64702?modeling=adw&Count=5
Úspěšná odpověď vypadá takto:
{
"id": "Related",
"name": "Related",
"version": "v1.0",
"interactionsVersion": "20220104115104",
"items": [
{
"id": "63102",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "62106",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "61511",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "63503",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "68100",
"trackingId": "00000000-0000-0000-0000-000000000003"
}
],
"title": "People also like",
"longTitle": "People also like",
"titleId": 1,
"pagingInfo": {
"totalItems": 138
},
"status": "Success"
}
Načtení podobných položek s mícháním
Aby se uživatelům zabránilo v zobrazení stejných doporučení znovu a znovu, má Intelligent Recommendations funkci váženého míchání, která mírně změní pořadí položek, aniž by to významně ovlivnilo relevanci. Výsledky lze zamíchat přidáním upřesnění enableshuffling. Další informace o vylepšeních a jeho různých typech se dozvíte zde.
Požadavek rozhraní API vypadá takto:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Similar/64702?modeling=adw&Count=5&Refinements=EnableShuffling
Úspěšná odpověď vypadá takto:
{
"id": "Related",
"name": "Related",
"version": "v1.0",
"interactionsVersion": "20220104115104",
"items": [
{
"id": "62403",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "61511",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "71603",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "64201",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "62452",
"trackingId": "00000000-0000-0000-0000-000000000003"
}
],
"title": "People also like",
"longTitle": "People also like",
"titleId": 1,
"pagingInfo": {
"totalItems": 138
},
"status": "Success"
}
Načtení konkrétního vzhledu
Tento požadavek API vezme složený obrázek a vrátí seznam doporučených položek, které jsou vizuálně podobné položkám uvedeným ve složeném obrázku. Složený obrázek a jeho mapování itemId lze nakonfigurovat pomocí datové entity obrázku na položku zde..
Požadavek API vypadá pro daný složený obrázek takto (642):
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Similar/642?AlgoType=BringSimilarItems
Úspěšná odpověď vypadá takto:
{
"id": "Related",
"name": "Related",
"version": "v1.0",
"interactionsVersion": "20220104115104",
"items": [
{
"id": "62403",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "61511",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "71603",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "64201",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "62452",
"trackingId": "00000000-0000-0000-0000-000000000003"
}
],
"title": "Bring Similar Items",
"longTitle": "Bring Similar Items",
"titleId": 1,
"pagingInfo": {
"totalItems": 138
},
"status": "Success"
}
Dokončení podobných stylů
Tento požadavek API vezme ID položky a vrátí seznam ID složených obrázků, které obsahují položku nebo obsahují různé podobné položky, přičemž podobnost je založena na vizuálním stylu.
Požadavek API vypadá pro dané ID položky (64702) obrázek takto:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Similar/64702?AlgoType=CompleteSimilarStyles
Úspěšná odpověď vypadá takto:
{
"id": "Related",
"name": "Related",
"version": "v1.0",
"interactionsVersion": "20220104115104",
"items": [
{
"id": "403",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "511",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "603",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "201",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "452",
"trackingId": "00000000-0000-0000-0000-000000000003"
}
],
"title": "Complete Similar Styles",
"longTitle": "Complete Similar Styles",
"titleId": 1,
"pagingInfo": {
"totalItems": 138
},
"status": "Success"
}
Dokončení podobných položek
Tento požadavek API vezme ID položky, najde složené obrázky, které obsahují položku nebo vizuálně podobnou položku, a vrátí seznam ID položek extrahovaných z těchto složených obrázků.
Požadavek API vypadá pro dané ID položky (64702) obrázek takto:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Similar/64702?AlgoType=CompleteSimilarItems
Úspěšná odpověď vypadá takto:
{
"id": "Related",
"name": "Related",
"version": "v1.0",
"interactionsVersion": "20220104115104",
"items": [
{
"id": "62403",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "61511",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "71603",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "64201",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "62452",
"trackingId": "00000000-0000-0000-0000-000000000003"
}
],
"title": "Complete Similar Items",
"longTitle": "Complete Similar Items",
"titleId": 1,
"pagingInfo": {
"totalItems": 138
},
"status": "Success"
}
Načtení výběru pro uživatele
Rozhraní API výběru vrací personalizovanou sadu doporučení na základě historie interakcí daného uživatele.
Požadavek rozhraní API vypadá takto:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Picks?modeling=adw&UserId=ID1644&Count=5
Úspěšná odpověď vypadá takto:
{
"id": "Picks",
"name": "Picks",
"version": "v1.0",
"items": [
{
"id": "68100",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "62500",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "61504",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "65103",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "61401",
"trackingId": "00000000-0000-0000-0000-000000000003"
}
],
"title": "Picks for you",
"longTitle": "Picks for you",
"titleId": 6,
"personalizationConfidence": 1.0,
"pagingInfo": {
"totalItems": 139
},
"status": "Success"
}
Načtení výběru pro uživatele pomocí sessionID
Rozhraní API výběru vrací personalizovaná doporučení na základě aktuálních zobrazení v relaci bez ohledu na to, zda je uživatel známý (přihlášený) nebo neznámý (anonymní). Parametr sessionId identifikuje produkty, které si uživatel prohlížel ve své aktuální relaci prohlížení, a rozhraní API vrací seznam doporučení na základě nedávné aktivity prohlížení přihlášeného nebo anonymního uživatele.
Upravený požadavek rozhraní API výběru nahradí userId za sessionId a použije AlgoType „Nedávná zobrazení“ daný následovně:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/picks?SessionId=123&AlgoType=RecentViews.
Poznámka:
Parametr SessionId se použivá v požadavku rozhraní API Podobné v dané relaci před voláním API pro výběr, jinak poslední doporučení aktivity vrátí prázdné výsledky.
Při použití rozhraní Similar API:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Similar/64702?SessionId=123
úspěšná odpověď posledního výběru aktivity je následující:
```json
{
"id": "Picks",
"name": "Picks",
"version": "v1.0",
"items": [
{
"id": "68100",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "62500",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "61504",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "65103",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "61401",
"trackingId": "00000000-0000-0000-0000-000000000003"
}
],
"title": "Picks for you",
"longTitle": "Picks for you",
"titleId": 6,
"personalizationConfidence": 1.0,
"pagingInfo": {
"totalItems": 139
},
"status": "Success"
}
Poznámka:
V tomto příkladu byl do požadavku API přidán parametr SessionId.
Další nejlepší akce
Požadavek API vrátí seznam položek, které jsou nejčastěji nakupovány společně s výchozími položkami v košíku uživatele (nebo spojené dohromady, pokud se nejedná o scénář maloobchodního košíku).
Požadavek API na jednu vybranou položku/akce je:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Cart/64702?AlgoType=DAS&modeling=adw&Count=5
Požadavek API na více vybraných položek/akcí je:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Cart/Items?SeedItemIds=22565300000,41023461-0005-0000-ffff-00ffffffff00,22565300000,22565300001&Count=5
Úspěšná odpověď je:
{
"id": "Cart",
"name": "Cart",
"version": "v1.0",
"items": [
{
"id": "63102",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "62106",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "61511",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "63503",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "68100",
"trackingId": "00000000-0000-0000-0000-000000000003"
}
],
"title": "Frequently bought together",
"longTitle": "Frequently bought together",
"titleId": 2,
"pagingInfo": {
"totalItems": 138
},
"status": "Success"
}
Označování metadat a sdružování uživatelů
Implementace označování metadat a segmentace uživatelů vyžaduje určité konfigurace datové smlouvy. V našem Průvodci značkováním metadat a sdružováním uživatelů naleznete přehled změn smluv o datech a příklady rozhraní API, včetně návodu dvou běžných případů použití, které těží ze značkování metadat a poskytují několik příkladů s ukázkovými daty pro každý z nich.
- Chcete-li získat „nejoblíbenější položky pro vás“ pro studené uživatele. Chcete-li vidět příklad, podívejte se do sekce s názvem „Získat nejoblíbenější položky pro studené uživatele“.
- K vytvoření strojově naučené mapy hodnot metadat uživatelů. Příklad naleznete v části s názvem „Vytvoření mapy ML hodnot metadat uživatelů“.
Jak používat parametr AlgoType
Funkce Intelligent Recommendations nabízí více algoritmů pro výpočet doporučení v různých scénářích. Pokud chcete použít specifický algoritmus jiný než výchozí, můžete použít parametr AlgoType.
Příklad AlgoType
Úplný seznam podporovaných AlgoType naleznete v Tabulce AlgoTypes . Příklady popisů AlgoType:
| AlgoType | definice | Podporované rozhraní API |
|---|---|---|
| RecentPurchases | Doporučení pro výběr se počítají na základě posledních nákupů uživatele. | K dispozici pouze s Rozhraním API výběru uživatelů. |
| Vizuální prvek | Podobnosti položek jsou vypočítány na základě vizuální podobnosti katalogových obrázků. | K dispozici pouze s rozhraním Similar API. |
| Textový | Podobnosti položek jsou počítány na základě textových (jazykových) podobností katalogových textových popisů. | K dispozici pouze s rozhraním Similar API. |
Vytvoření požadavku API pomocí AlgoType
Požadavek API na přidání typu algoritmu do požadavku API pro výběr uživatele vypadá takto:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Picks?AlgoType=RecentPurchases&modeling=adw&UserId=ID1644&Count=5
Úspěšná odpověď vypadá takto:
{
"id": "Picks",
"name": "Picks",
"version": "v1.0",
"items": [
{
"id": "61100",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "61406",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "63203",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "73401",
"trackingId": "00000000-0000-0000-0000-000000000003"
},
{
"id": "71801",
"trackingId": "00000000-0000-0000-0000-000000000003"
}
],
"title": "Picks for you",
"longTitle": "Picks for you",
"titleId": 6,
"pagingInfo": {
"totalItems": 327
},
"status": "Success"
}
Jak používat parametr vylepšení
Funkce Intelligent Recommendations nabízí různé způsoby chování pro výpočet a vrácení doporučení, ale někdy je pro lepší prostředí nákupu nutné požádat o jiné chování, než je výchozí. Například zobrazení doporučení pouze na nezakoupené položky nebo zabránění opakování stejné objednávky. Parametr vylepšení lze v takových případech použít k dosažení požadovaného chování doporučení.
Úplný seznam podporovaných vylepšení naleznete v Tabulce vylepšení .
Vytvoření požadavku API pomocí vylepšení
Můžete přidat více vylepšení oddělených čárkou, pokud si navzájem neodporují. Ukázkový požadavek rozhraní API na přidání vylepšení do Podobného rozhraní API naleznete zde.
Stavové kódy API
Úplný seznam stavových kódů API, popisů a způsobů řešení chyb je následující:
| Kód | Stav | Důvod | Postup řešení |
|---|---|---|---|
| 200 | Akce proběhla úspěšně | Požadavek rozhraní API byl úspěšný. | – |
| 200 | EmptyResults | Existují doporučení pro tuto počáteční položku (itemId), všechna však byla odfiltrována. | Hlavním důvodem filtrování jsou data spojená s položkami v katalogu. Když očekáváte vrácení určitých produktů, je důležité ověřit data jejich dostupnosti a zajistit, aby byly správně nakonfigurovány s příslušným přiřazením filtrování, jako je kategorie, kanál, katalog a dostupnost. |
| 200 | DataDoesNotExist | Výchozí položka (itemId) ve výsledcích neexistuje. Zadané itemId může ve vstupních datech chybět nebo nemá dostatek dat pro výpočet výsledků. | Zkontrolujte, zda položka: - ke platná - patří do správného kanálu - má dostatek interakcí/obrázků/textu. Další informace najdete v pokynech pro formátování dat datové smlouvy. |
| 200 | WaitingForData | Když je vytvořena nová komponenta modelování, výpočet může nějakou dobu trvat a nemusí být připraven vrátit výsledky. | Zkontrolujte protokoly nebo zprávu o stavu modelování, abyste zjistili, zda tam nejsou chyby. Pokud po 24 hodinách problém přetrvává bez protokolování chyb, kontaktujte nás. |
| 400 | UnsupportedRequest | Jeden z parametrů rozhraní API má nepodporovanou hodnotu nebo došlo k jinému problému s požadavkem rozhraní API, například nepodporovaný nebo deaktivovaný scénář. | Zkontrolujte, zda se hodnota záhlaví liší od skutečného parametru. Příklady pracovních požadavků API: přejděte na začátek tohoto článku. Různé požadavky API jsou deaktivovány v závislosti na tom, zda je vaše sada funkcí modelování nakonfigurována Standardní nebo Prémiové. Můžete také zkontrolovat zprávu o stavu modelování a zjistit, zda v některém z algoritmů nejsou chyby. |
| 400 | UnsupportedFeature | Pokoušíte se volat rozhraní API, které je na základě vaší aktuální sady funkcí modelování nepodporováno. | Zapněte správnou funkci modelování nastavenou na standardní nebo prémiovou. Seznam dostupných scénářů pro každou sadu funkcí. |
| 401 | Neověřený požadavek | Ujistěte se, že váš tenant má přidělená oprávnění pro provoz služby. Ke kontrole ověřování postupujte následovně. | |
| 408 | RequestTimeout | Časový limit žádosti vypršel. | Zkuste znovu zavolat požadavek API. |
| 429 | RPS je nad předem přidělenou úrovní a hrozí, že bude omezen. | Zvyšte předem přidělenou kapacitu RPS na vyšší úroveň nebo snižte aktuální RPS. | |
| 500 | Vnitřní chyba serveru | Na straně Intelligent Recommendations došlo k chybě. | Tento problém může být dočasný, zkuste to za několik minut znovu. Zkontrolujte protokoly nebo zprávu o stavu modelování, abyste zjistili, zda tam nejsou chyby. Pokud problém přetrvává bez protokolování chyb, kontaktujte nás. |
| 503 | ServiceUnavailable | Služba nemůže zpracovat účet. | Zkontrolujte protokoly nebo zprávu o stavu modelování, abyste zjistili, zda tam nejsou chyby. Pokud problém přetrvává bez protokolování chyb, kontaktujte nás. |
Viz také
Rozhraní API Intelligent RecommendationsPříručka pro rychlý start s voláním rozhraní APIBěžné chyby protokolováníPřehled datové smlouvy