Voorbeeld-API-aanvragen

Belangrijk

Buitengebruikstelling en migratieplan voor Azure Intelligent Recommendations

Azure Intelligent Recommendations wordt op 31 maart 2026 buiten gebruik gesteld.

We gaan het product buiten gebruik stellen vanwege wijzigingen in de strategie en focus met het nieuwe copilot-tijdperk. Er zijn momenteel geen equivalente services beschikbaar in de Microsoft-stack, dus we kunnen geen migratieplan aanbieden aan een vergelijkbare service.

Volgende stappen:

Een alternatief identificeren of bouwen.
Migreer al uw verkeer naar het gekozen alternatief.
Stop met het aanroepen van het aanbevelingen-eindpunt vóór de afsluitdatum.
Verwijder alle service-eindpunten, modellering en IR-accounts in Azure Portal vóór de afsluitdatum.

We blijven Azure Intelligent Recommendations bewaken en onderhouden tijdens de buitengebruikstellingsperiode. Nadat het product buiten gebruik is gesteld, bewaren we de servicegegevens drie maanden voordat u het verwijdert.

Dit artikel bevat enkele voorbeelden van API-aanvragen en bijbehorende antwoorden. In elk voorbeeld ziet u een scenario met basisaanbevelingen, samen met andere functies voor het aanpassen van antwoorden, zoals filteren, paginering, het selecteren van een alternatief algoritme en meer. Als u deze voorbeelden wilt uitproberen op uw Eindpunt intelligente aanbevelingen, moet u de eindpuntnaam (DNS-onderdeel) vervangen en de parameters aanpassen aan uw gegevens.

Opmerking

De parameter 'aantal' regelt het aantal items dat in elke reactie wordt geretourneerd. Voorbeelden hebben het aantal ingesteld op 5 voor duidelijkheid en beknoptheid. Zie intelligent recommendations-API en quickstartgids voor het aanroepen van de API voor meer informatie over manieren om uw API-aanvragen te maken.

Examples

Hier volgen enkele voorbeelden die u kunt testen met uw Intelligent Recommendations-account:

Als er fouten optreden tijdens het testen van de antwoorden, raadpleegt u de foutenlogboeken.

Nieuwe items ophalen

De API Nieuwe items retourneert een lijst met producten die zijn besteld op releasedatum.

De API-aanvraag ziet er als volgt uit:

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

Een geslaagd antwoord ziet er als volgt uit:

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

AlgoType	Definitie	Ondersteunde API
Recente opdrachten	Aanbevelingen voor selecties worden berekend op basis van de meest recente aankopen van de gebruiker.	Alleen beschikbaar met de User Picks API.
Visueel	Item-overeenkomsten worden berekend op basis van visuele overeenkomsten van catalogusafbeeldingen.	Alleen beschikbaar met de vergelijkbare API.
Tekstueel	Itemovereenkomsten worden berekend op basis van tekstuele (taalbegrip) overeenkomsten van catalogusteksten.	Alleen beschikbaar met de vergelijkbare API.

Code	Status	Reden	Hoe op te lossen
200	Success	De API-aanvraag is geslaagd.	N/A
200	Lege Resultaten	Er zijn aanbevelingen voor dit seed-item (itemId), maar ze zijn allemaal uitgefilterd.	De belangrijkste reden voor filteren zijn gegevens die zijn gekoppeld aan de items in de catalogus. Wanneer u verwacht dat bepaalde producten worden geretourneerd, is het belangrijk om hun beschikbaarheidsdatums te controleren en ervoor te zorgen dat ze correct zijn geconfigureerd met de juiste filtertoewijzingen, zoals categorie, kanaal, catalogus en beschikbaarheid.
200	DataBestaatNiet	Het seed-item (itemId) bestaat niet in de resultaten. De opgegeven itemId ontbreekt mogelijk in de invoergegevens of beschikt niet over voldoende gegevens om berekende resultaten te hebben.	Controleer of het item is: - is geldig - behoort tot het juiste kanaal - Heeft voldoende interacties/afbeeldingen/tekst. Raadpleeg de opmaakhandleiding voor het gegevenscontract voor meer informatie.
200	WaitingForData	Wanneer er een nieuw modelleringsonderdeel wordt gemaakt, kan het enige tijd duren voordat berekeningen zijn voltooid en zijn ze mogelijk niet klaar om resultaten te retourneren.	Controleer de logboeken of het modelleringsstatusrapport om te zien of er fouten zijn. Als het probleem zich na 24 uur blijft voordoen zonder logboekregistratie, neemt u contact met ons op.
400	Niet-ondersteundVerzoek	Een van de API-parameters heeft een niet-ondersteunde waarde of er is een ander probleem met de API-aanvraag, zoals: een niet-ondersteund of uitgeschakeld scenario.	Controleer of de headerwaarde anders is dan de werkelijke parameter. Voor voorbeelden van werkende API-aanvragen gaat u naar het begin van dit artikel. Verschillende API-aanvragen worden uitgeschakeld, afhankelijk van of uw modelleringsfunctieset is geconfigureerd voor Standard of Premium. U kunt ook het modelleringsstatusrapport controleren om te zien of er fouten zijn met een van de algoritmen.
400	Niet-ondersteundeFunctie	U probeert een API aan te roepen die niet wordt ondersteund op basis van uw huidige modelleringsfunctieset.	Schakel de juiste modelleringsfunctie in op Standard of Premium. Lijst met welke scenario's beschikbaar zijn voor elke functieset.
401		Niet-geverifieerde aanvraag	Zorg ervoor dat uw tenant machtigingen heeft toegewezen om de service te laten werken. Volg deze stappen om uw verificatie te controleren.
408	RequestTimeout	Er is een time-out opgetreden voor uw aanvraag.	Probeer de API-aanvraag opnieuw aan te roepen.
429		RPS bevindt zich op een hogere dan vooraf toegewezen limiet en riskeert beperking.	Verhoog de vooraf toegewezen RPS-capaciteit naar een hogere laag of verlaag de huidige RPS.
500	Interne serverfout	Er is een fout opgetreden aan de kant van Intelligente aanbevelingen.	Dit probleem kan tijdelijk zijn, dus probeer het na een paar minuten opnieuw. Controleer de logboeken of het modelleringsstatusrapport om te zien of er fouten zijn. Als het probleem zich blijft voordoen zonder fouten in logboekregistratie, neemt u contact met ons op.
503	DienstNietBeschikbaar	De service kan het account niet verwerken.	Controleer de logboeken of het modelleringsstatusrapport om te zien of er fouten zijn. Als het probleem zich blijft voordoen zonder fouten in logboekregistratie, neemt u contact met ons op.

Voorbeeld-API-aanvragen

Examples

Nieuwe items ophalen

Nieuwe items krijgen met overslaan van de beste 3

Populaire items ophalen

Populaire items in een specifieke categorie ophalen

Populaire items in een specifieke categorie ophalen met een discreet filter

Populaire items in een specifieke categorie ophalen en daarbij filteren binnen een bereik van waarden

Vergelijkbare items ophalen

Vergelijkbare items ophalen met shuffling

Breng het uiterlijk

Vergelijkbare stijlen voltooien

Vergelijkbare items voltooien

Gebruikerskeuzes ophalen

Gebruikerskeuzes ophalen door sessionId

Volgende beste actie

Metagegevens taggen en gebruikers indelen

De parameter AlgoType gebruiken

Voorbeeld van AlgoTypes

Een API-aanvraag maken met AlgoType

De parameter Verfijningen gebruiken

Een API-aanvraag maken met verfijningen

API-statuscodes

Zie ook

Feedback

Aanvullende resources