Del via


Eksempler på API-anmodninger

I denne artikel vises eksempler på API-forespørgsler og tilknyttede svar. Hvert eksempel viser et scenarie med et grundlæggende anbefalingsscenarie sammen med andre funktioner til ændring af svar, f.eks. filtrering, sideinddeling, valg af alternativ algoritme og meget mere. Hvis du vil afprøve disse eksempler på dit slutpunkt for Intelligent Recommendations, skal du sørge for at erstatte slutpunktsnavnet (DNS-delen) og justere parametrene til dine data.

Bemærk

Optællingsparameteren styrer antallet af varer, der returneres i hvert svar. I eksemplerne bliver optællingen sat til 5 for at gøre det tydeligt og kort. Du kan finde flere oplysninger om, hvordan du bygger dine API-anmodninger, i API til Intelligent Recommendations og Startvejledning til at kalde API'en.

Eksempler

Her er nogle eksempler, som du kan teste med kontoen til Intelligent Recommendations:

Hvis du oplever fejl under test af svarene, skal du se Fejllogfiler.

Hent nye varer

Nye varer-API'en returnerer en liste over produkter i rækkefølge efter udgivelsesdato.

API-anmodningen ser sådan ud:

https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/New?modeling=adw&Count=5

Et vellykket svar ser således ud:

{
    "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"
}

Tilbage til toppen

Hent nye varer, mens du springer top 3 over

Du kan springe varer over på en liste ved at føje "SkipItems" til anmodningen.

API-anmodningen ser sådan ud:

https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/New?modeling=adw&Count=5&SkipItems=3

Et vellykket svar ser således ud:

{
    "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"
}

Tilbage til toppen

Hent populære varer-API'en returnerer en liste over varer i rækkefølge efter antal interaktioner, f.eks. transaktion, køb, visning, valg eller download. Uanset hvad en interaktion mellem bruger og vare betyder i din virksomhed, er den første vare på listen den vare, der har flest interaktioner, og resten sorteres i faldende rækkefølge.

API-anmodningen ser sådan ud:

https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Popular?modeling=adw&Count=5

Et vellykket svar ser således ud:

{
    "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"
}

Tilbage til toppen

Du kan definere kategorier i dataobjektet ItemCategories. Du kan finde flere oplysninger i Oversigt over datakontrakt.

API-anmodningen, når der søges efter de mest populære tøjvarer, ser således ud:

https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Popular?modeling=adw&Count=5&Category=Clothing

Et vellykket svar ser således ud:

{
    "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"
}

Tilbage til toppen

Du kan definere filtre i dataobjektet ItemAndVariantFilters. Du kan finde flere oplysninger i Oversigt over datakontrakt.

API-anmodningen ser sådan ud:

https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Popular?modeling=adw&Count=5&Category=Clothing&Size=S

Et vellykket svar ser således ud:

{
    "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"
}

Tilbage til toppen

Du kan finde flere oplysninger om syntaksen for filtrering efter område i vejledningen til områdefiltre.

API-anmodningen ser sådan ud:

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

Et vellykket svar ser således ud:

{
    "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"
}

Tilbage til toppen

Hent lignende varer

API'en til lignende varer indeholder kontekstafhængige anbefalinger, der er baseret på specifikke varer. Basisenheden er omdrejningspunktet, som produktforslagene er baseret på. Den API-anmodning, der blev givet til vare-id'et med adgang, følger lige efter Lignende. En basisenhed med en stribet sweater har f.eks. andre produktforslag end en jakke til et herrejakkesæt.

API-anmodningen ser sådan ud:

https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Similar/64702?modeling=adw&Count=5

Et vellykket svar ser således ud:

{
    "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"
}

Tilbage til toppen

Hent lignende varer med blanding

Intelligent Recommendations har en vægtet blandingsfunktion, der ændrer varernes rækkefølge en smule, uden at relevansen påvirkes væsentligt, så brugerne ikke får vist de samme anbefalinger igen og igen. Resultaterne kan blandes ved at tilføje den justerende enableshuffling. Du kan få mere at vide om forbedringer og deres forskellige typer her.

API-anmodningen ser sådan ud:

https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Similar/64702?modeling=adw&Count=5&Refinements=EnableShuffling

Et vellykket svar ser således ud:

{
    "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"
}

Tilbage til toppen

Hent looket

Denne API-anmodning tager et sammensat billede og returnerer en liste over anbefalede varer, der visuelt ligner de varer, som vises på det sammensatte billede. Et sammensat billede og dets itemIds-tilknytning kan konfigureres ved hjælp af Dataobjekt for billede til element her.

API-anmodningen ser således ud for et bestemt sammensat billede (642):

https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Similar/642?AlgoType=BringSimilarItems

Et vellykket svar ser således ud:

{
    "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"
}

Tilbage til toppen

Find lignende stil

I denne API-anmodning tages et vare-id, og der returneres en liste over sammensatte billed-id'er, der indeholder varen eller en anden lignende vare, hvor ligheden er baseret på visuel stil.

API-anmodningen ser således ud for et bestemt vare-id (64702):

https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Similar/64702?AlgoType=CompleteSimilarStyles

Et vellykket svar ser således ud:

{
    "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"
}

Tilbage til toppen

Find lignende varer

I denne API-anmodning tages et vare-id, der findes sammensatte billeder, som indeholder varen eller en visuelt lignende vare, og der returneres en liste over vare-id'er, der er udtrukket fra disse sammensatte billeder.

API-anmodningen ser således ud for et bestemt vare-id (64702):

https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Similar/64702?AlgoType=CompleteSimilarItems

Et vellykket svar ser således ud:

{
    "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"
}

Tilbage til toppen

Hent brugervalg

API'en for valg returnerer et tilpasset sæt anbefalinger baseret på en bestemt brugers interaktionshistorik.

API-anmodningen ser sådan ud:

https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Picks?modeling=adw&UserId=ID1644&Count=5

Et vellykket svar ser således ud:

{
    "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"
}

Tilbage til toppen

Hent brugervalg ved hjælp af sessionId

API'en for valg returnerer tilpassede anbefalinger baseret på de aktuelle visninger i en session, uanset om brugeren er kendt (logget på) eller ukendt (anonym). Parameteren sessionId identificerer de produkter, en bruger har set i sin aktuelle browsersession, og API'en returnerer en liste over anbefalinger baseret på den seneste visningsaktivitet for den bruger, der er logget på, eller en anonym bruger.

Den ændrede API-anmodning for valg erstatter userId med sessionId og bruger "Seneste visninger" for AlgoType, som vises på følgende måde:

https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/picks?SessionId=123&AlgoType=RecentViews.

Bemærk

Parameteren SessionId skal bruges i en lignende API-forespørgsel i den givne session, før du kalder pluk-API'en, da de seneste aktivitetsanbefalinger ellers returnerer tomme resultater.

Når du bruger API for lignende varer:

https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Similar/64702?SessionId=123 

Et vellykket svar på valg ud fra seneste aktivitet er følgende:


```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"
}

Bemærk

Parameteren SessionId er blevet føjet til API-anmodningen i dette eksempel.

Tilbage til toppen

Næste bedste handling

API-anmodningen returnerer en liste over varer, der oftest købes sammen med basisvarerne i en brugers indkøbskurv (eller som passer sammen, når de ikke er i et scenarie med en indkøbskurv).

API-anmodningen for enkelte basisenheder/handlinger er:

https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Cart/64702?AlgoType=DAS&modeling=adw&Count=5

API-anmodningen for flere basisenheder/handlinger er:

https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Cart/Items?SeedItemIds=22565300000,41023461-0005-0000-ffff-00ffffffff00,22565300000,22565300001&Count=5

Et vellykket svar er:

{
    "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"
}

Tilbage til toppen

Mærkning af metadata og brugerinddeling

Implementering af metadatatagging og brugerinddeling kræver visse konfigurationer i datakontrakten. Se vores Vejledning til mærkning af metadata og brugerinddeling for at en oversigt over ændringer af datakontrakter og API-eksempler, herunder en gennemgang af to almindelige brugsscenarier, der drager fordel af mærkning af metadata, og viser nogle eksempler med demodata for hver.

  1. Sådan opretter du "de mest populære varer til dig" til kolde brugere. Hvis du vil se et eksempel, skal du se afsnittet med titlen "Hent de mest populære varer til dig til kolde brugere".
  2. Sådan opretter du et maskinoplært kort over brugernes metadataværdier. Hvis du vil se et eksempel, skal du se afsnittet med titlen "Opret et ML-kort over brugernes metadataværdier".

Tilbage til toppen

Sådan bruger du AlgoType-parameteren

Intelligent Recommendations-funktionen indeholder flere algoritmer til beregning af anbefalinger i flere scenarier. Hvis du vil bruge en anden algoritme end standardalgoritmen, kan du bruge parameteren AlgoType.

Eksempel på AlgoTypes

Se AlgoTypes-tabellen for at få vist den komplette liste over aktuelt understøttede AlgoTypes. Eksempler på AlgoTypes omfatter:

AlgoType Definition Understøttet API
RecentPurchases Valganbefalinger beregnes på baggrund af brugerens seneste køb. Kun tilgængelig med API'en for brugervalg.
Visuelt element Ligheder mellem varer beregnes ud fra visuelle ligheder mellem katalogbilleder. Kun tilgængelig med den lignende API.
Tekstbaserede Ligheder mellem varer beregnes ud fra tekstmæssige ligheder (sprogforståelse) i katalogtekstbeskrivelser. Kun tilgængelig med den lignende API.

Opbygning af en API-anmodning med AlgoType

API-anmodningen om tilføjelse af en AlgoType til en API-anmodning for Hent brugervalg ser således ud:

https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Picks?AlgoType=RecentPurchases&modeling=adw&UserId=ID1644&Count=5

Et vellykket svar ser således ud:

{
    "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"
}

Tilbage til toppen

Sådan bruges forbedringsparameteren

Funktionen Intelligente anbefalinger indeholder forskellige funktioner til beregning og returnering af anbefalinger, men nogle gange er det nødvendigt at anmode om en anden funktionsmåde end standardfunktionsmåden for at opnå en bedre købsoplevelse. Du kan f.eks. kun få vist anbefalinger på ikke-købte elementer eller forhindre, at den samme ordre anvendes. I sådanne tilfælde kan parameteren Finjusteringer bruges til at opnå den ønskede anbefalingsfunktionsmåde.

Se Forbedringer-tabellen for at få vist den komplette liste over understøttede forbedringer.

Opbygning af en API-anmodning med forbedringer

Du kan tilføje flere finjusteringer adskilt af kommaer, så længe de ikke er i modstrid med hinanden. Du kan se prøve-API-anmodning om tilføjelse af en finjustering til en lignende API her.

API-statuskoder

En komplet liste over API-statuskoder, beskrivelser, og hvordan du kan løse fejl, er følgende:

Kode Status Årsag Sådan løses problemet
200 Udført API-anmodningen blev udført. I/R
200 EmptyResults Der er anbefalinger til denne vare med adgang (itemId), men de blev alle filtreret ud. Den primære årsag til filtreringen er data, der er knyttet til varerne i kataloget. Når du forventer, at visse produkter skal returneres, er det vigtigt at kontrollere deres tilgængelighedsdato og sikre, at de er konfigureret korrekt med de relevante filtreringstildelinger, f.eks. kategori, kanal, katalog og tilgængelighed.
200 DataDoesNotExist Varen med adgang (itemId) findes ikke i resultaterne. Det angivne itemId mangler muligvis i inputdataene eller har ikke tilstrækkelige data til at have beregnede resultater. Kontrollér, at varen:
- er gyldig
- tilhører den rigtige kanal
- har interaktioner/billeder/tekst nok. Du kan finde flere oplysninger i retningslinjerne for formatering af datakontrakter.
200 WaitingForData Når der oprettes en ny modelleringskomponent, kan det tage nogen tid at beregne den, og den er muligvis ikke klar til at returnere resultater. Kontrollér loggene eller modelleringsstatusrapporten for at se, om der er fejl. Kontakt os, hvis problemet varer ved efter 24 timer uden fejllogføring.
400 UnsupportedRequest Et af API-parametrene har en ikke-understøttet værdi, eller der er et andet problem med API-anmodningen, f.eks. et ikke-understøttet eller deaktiveret scenario. Kontrollér, om overskriftsværdien er en anden end den faktiske parameter. Du kan se eksempler på fungerende API-forespørgsler ved at gå til toppen af denne artikel. Forskellige API-anmodninger deaktiveres, afhængigt af om din modelleringsfunktion er konfigureret til Standard eller Premium. Du kan også kontrollere modelleringsstatusrapporten for at se, om der er fejl i nogen af algoritmerne.
400 UnsupportedFeature Du forsøger at kalde en API, der ikke understøttes, på basis af den aktuelle modelleringsfunktion. Aktivér den rette modelleringsfunktion, der er angivet til standard eller premium. Liste over, hvilke scenarier der er tilgængelige for de enkelte funktionssæt.
401 Ikke-godkendt anmodning Kontrollér, at lejeren har fået tildelt tilladelser til at betjene tjenesten. Følg disse trin for at kontrollere din godkendelse.
408 RequestTimeout Anmodningen fik timeout. Prøv at kalde API-anmodningen igen.
429 RPS er over det forudallokerede niveau og er i risiko for at blive begrænset. Forøg den forudallokerede RPS-kapacitet til et højere niveau, eller reducer den aktuelle RPS.
500 Intern serverfejl Der opstod en fejl på siden Intelligent Recommendations. Dette problem kan være midlertidigt, så prøv igen efter et par minutter. Kontrollér loggene eller modelleringsstatusrapporten for at se, om der er fejl. Kontakt os, hvis problemet varer ved uden logføring af fejl.
503 ServiceUnavailable Tjenesten kan ikke behandle kontoen. Kontrollér loggene eller modelleringsstatusrapporten for at se, om der er fejl. Kontakt os, hvis problemet varer ved uden logføring af fejl.

Tilbage til toppen

Se også

API for Intelligent Recommendations
Startvejledning til at kalde API'en
Almindelige logføringsfejl
Oversigt over datakontrakt