Compartir a través de


Solicitudes de API de muestra

Este artículo muestra algunos ejemplos de solicitudes de API y respuestas asociadas. Cada ejemplo muestra un escenario de recomendaciones base junto con otras funciones de modificación de respuesta, como filtrado, paginación, selección de un algoritmo alternativo y más. Si desea probar estos ejemplos en sus Intelligent Recommendations punto de conexión, asegúrese de reemplazar el nombre punto de conexión (parte DNS) y ajuste los parámetros a sus datos.

Nota

El parámetro de conteo controlará la cantidad de elementos devueltos en cada respuesta. Los ejemplos tendrán el conteo establecido en 5 para mayor claridad y brevedad. Para obtener más información sobre las formas de construir sus solicitudes de API, consulte API de Intelligent Recommendations y Guía de inicio rápido para llamar a la API.

Ejemplos

Estos son algunos ejemplos que puede probar con su cuenta de Intelligent Recommendations:

Si se encuentra con errores al probar las respuestas a continuación, consulte Registros de errores.

Obtener nuevos elementos

La API New Items devuelve una lista de productos ordenados por fecha de lanzamiento.

La solicitud de API tiene el aspecto siguiente:

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

Una respuesta exitosa se ve así:

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

Volver arriba

Obtener nuevos artículos mientras salta los 3 principales

Puede omitir elementos en una lista agregando "SkipItems" a la solicitud.

La solicitud de API tiene el aspecto siguiente:

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

Una respuesta exitosa se ve así:

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

Volver arriba

La API Get Popular Items devuelve una lista de elementos ordenados por recuento de interacciones, como transacción, compra, visualización, selección o descarga. Cualquiera que sea el significado de una interacción usuario-elemento en su negocio, el primer elemento de la lista es el que tiene más interacciones, y el resto se ordenan de forma descendente.

La solicitud de API tiene el aspecto siguiente:

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

Una respuesta exitosa se ve así:

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

Volver arriba

Puede definir categorías dentro de la entidad de datos ItemCategories. Para obtener más información, consulte Información general de los contratos de datos.

La solicitud de API al buscar las prendas de vestir más populares se ve así:

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

Una respuesta exitosa se ve así:

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

Volver arriba

Puede definir filtros dentro de la entidad de datos ItemAndVariantFilters. Para obtener más información, consulte Información general de los contratos de datos.

La solicitud de API tiene el aspecto siguiente:

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

Una respuesta exitosa se ve así:

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

Volver arriba

Para obtener más información sobre la sintaxis de filtrado por rango, consulte la guía de filtros de rango.

La solicitud de API tiene el aspecto siguiente:

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

Una respuesta exitosa se ve así:

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

Volver arriba

Obtener artículos similares

La API de elementos similares proporciona recomendaciones contextuales basadas en elementos iniciales específicos. El elemento inicial es el punto de pivote en el que se basarán las sugerencias de productos. La solicitud de API dada para ID de elemento semilla inmediatamente sigue a Similar/. Por ejemplo, un artículo de semillas de suéter a rayas tendrá diferentes sugerencias de productos en comparación con una chaqueta de traje de hombre.

La solicitud de API tiene el aspecto siguiente:

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

Una respuesta exitosa se ve así:

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

Volver arriba

Obtener artículos similares con combinación aleatoria

Para evitar que los usuarios vean las mismas recomendaciones una y otra vez, las Intelligent Recommendations tienen una función de reproducción aleatoria ponderada que cambia ligeramente el orden de los elementos sin afectar significativamente la relevancia. Los resultados se pueden barajar agregando el refinamiento enableshuffling. Puede obtener más información sobre los refinamientos y sus diferentes tipos aquí.

La solicitud de API tiene el aspecto siguiente:

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

Una respuesta exitosa se ve así:

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

Volver arriba

Traiga el look

Esta solicitud de API toma una imagen compuesta y devuelve una lista de elementos recomendados que son visualmente similares a los elementos enumerados en la imagen compuesta. Una imagen compuesta y su mapeo de itemIds se pueden configurar usando la entidad de datos de imagen a artículo.

La solicitud de API se ve así para una imagen compuesta dada (642):

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

Una respuesta exitosa se ve así:

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

Volver arriba

Completar estilos similares

Esta solicitud de API toma un id. de elemento y devuelve una lista de id. de imágenes compuestas que contienen el elemento o contienen diferentes elementos similares, donde la similitud se basa en el estilo visual.

La solicitud de API se ve así para un id. de elemento compuesto (64702):

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

Una respuesta exitosa se ve así:

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

Volver arriba

Completar elementos similares

Esta solicitud de API toma un id. de elemento, encuentra imágenes compuestas que contienen el elemento o un elemento visualmente similar y devuelve una lista de id. de elementos extraídos de esas imágenes compuestas.

La solicitud de API se ve así para un id. de elemento compuesto (64702):

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

Una respuesta exitosa se ve así:

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

Volver arriba

Obtener selecciones de usuario

La API de selecciones devuelve un conjunto personalizado de recomendaciones basadas en el historial de interacciones de un usuario determinado.

La solicitud de API tiene el aspecto siguiente:

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

Una respuesta exitosa se ve así:

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

Volver arriba

Obtener selecciones de usuarios usando sessionId

La API de selecciones devuelve recomendaciones personalizadas basadas en las vistas actuales en una sesión, independientemente de si el usuario es conocido (iniciado sesión) o desconocido (anónimo). El parámetro sessionId identifica los productos que un usuario ha visto en su sesión de navegación actual y la API devuelve una lista de recomendaciones basadas en la actividad de visualización reciente del usuario anónimo o que ha iniciado sesión.

La solicitud modificada de la API de selecciones reemplaza el ID de usuario con el ID de sesión y utiliza el AlgoType "Vistas recientes", dado de la siguiente manera:

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

Nota

El parámetro SessionId debe usarse en la solicitud de API similar en la sesión dada antes de llamar a la API de selecciones; de lo contrario, las recomendaciones de actividad recientes arrojan resultados vacíos.

Al usar la API similar:

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

una respuesta exitosa de selecciones de actividad reciente es la siguiente:


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

Nota

El parámetro SessionId se agregó a la solicitud de API en este ejemplo.

Volver arriba

Mejor siguiente acción

La solicitud de API devolverá una lista de artículos que se compran con mayor frecuencia junto con los artículos iniciales en el carrito de un usuario (o combinados, cuando no se trata de un escenario de carrito minorista).

La solicitud de API para acciones/elementos de semilla es:

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

La solicitud de API para acciones/elementos de semilla múltiple es:

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

Una respuesta correcta es:

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

Volver arriba

Etiquetado de metadatos y agrupación de usuarios

La implementación del etiquetado de metadatos y la agrupación de usuarios requiere algunas configuraciones en el contrato de datos. Consulte nuestra Guía para el etiquetado de metadatos y la clasificación de usuarios para obtener una descripción general de los cambios en el contrato de datos y ejemplos de API, incluido un tutorial de dos casos de uso comunes que se benefician del etiquetado de metadatos y brindan algunos ejemplos con datos de demostración para cada uno.

  1. Para obtener los "artículos más populares para usted" para usuarios en frío. Para ver un ejemplo, consulte la sección titulada "Obtenga los artículos más populares para usted para usuarios fríos".
  2. Para crear un mapa de aprendizaje automático de los valores de metadatos de los usuarios. Para ver un ejemplo, consulte la sección titulada "Crear un mapa ML de los valores de metadatos de los usuarios".

Volver arriba

Cómo usar el parámetro AlgoType

Intelligent Recommendations admite varios algoritmos para calcular recomendaciones en varios escenarios. Si desea utilizar un algoritmo específico que no sea el predeterminado, puede utilizar el parámetro AlgoType.

AlgoTypes de ejemplo

Consulte la Tabla AlgoTypes para obtener la lista completa de AlgoTypes compatibles actualmente. Estos son algunos ejemplos de AlgoTypes:

AlgoType Definición API admitida
RecentPurchases Las recomendaciones de selecciones se calculan en función de las compras más recientes del usuario. Solo disponible con el API de selecciones de usuarios.
Objeto visual Las similitudes de los elementos se calculan en función de las similitudes visuales de las imágenes del catálogo. Solo disponible con el API similar.
Textual Las similitudes de los elementos se calculan en función de las similitudes textuales (comprensión del idioma) de las descripciones textuales del catálogo. Solo disponible con el API similar.

Construir una solicitud de API con AlgoType

La solicitud de API para agregar un AlgoType a una solicitud de API para obtener selecciones de usuarios se ve así:

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

Una respuesta exitosa se ve así:

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

Volver arriba

Cómo usar el parámetro Refinements

La función Intelligent Recommendations ofrece varios comportamientos para calcular y devolver recomendaciones, pero a veces es necesario solicitar un comportamiento diferente al predeterminado para una mejor experiencia de compra. Por ejemplo, mostrar recomendaciones solo sobre artículos no comprados o evitar la repetición del mismo pedido. El parámetro Refinements se puede utilizar en tales casos para lograr el comportamiento de recomendación deseado.

Consulte la Tabla Refinements para ver la lista completa de refinamientos admitidos actualmente.

Construir una solicitud de API con Refinements

Puede agregar varios refinamientos separados por comas, siempre que no se contradigan entre sí. Puede encontrar una solicitud de API de muestra para agregar un refinamiento a API similar aquí.

Códigos de estado de API

A continuación se incluye una lista completa de códigos de estado de la API, descripciones y cómo resolver errores:

Código Estado Motivo Cómo resolver
200 Correcto La solicitud de API se realizó correctamente. N/A
200 EmptyResults Hay recomendaciones para este elemento semilla (itemId), pero, sin embargo, todos se filtraron. El principal motivo de filtrado son los datos asociados a los artículos del catálogo. Cuando prevé la devolución de ciertos productos, es importante verificar sus fechas de disponibilidad y asegurarse de que estén configurados correctamente con las asignaciones de filtrado adecuadas, como categoría, canal, catálogo y disponibilidad.
200 DataDoesNotExist El elemento semilla (itemId) no existe en los resultados. El itemId especificado puede faltar en los datos de entrada o no tiene suficientes datos para tener resultados calculados. Compruebe que el artículo:
- es válido
- pertenece al canal correcto
- Tiene suficientes interacciones/imágenes/texto. Para obtener más información, consulte Comprobar la guía de de formato del contrato de datos.
200 WaitingForData Cuando se crea un nuevo componente de modelado, el cálculo puede tardar algún tiempo y es posible que no esté listo para devolver resultados. Consulte los registros o el informe de estado de modelado para ver si hay errores. Si, después de 24 horas, el problema persiste sin registro de errores, contáctenos.
400 UnsupportedRequest Uno de los parámetros de la API tiene un valor no admitido o hay otro problema con la solicitud de la API, como: un escenario no admitido o deshabilitado. Verifique si el valor del encabezado es diferente al parámetro real. Para ver ejemplos de solicitudes de API en funcionamiento, vaya al principio de este artículo. Se deshabilitan diferentes solicitudes de API dependiendo de si su conjunto de características de modelado está configurado en Estándar o Premium. También puede consultar el informe de estado de modelado para ver si hay errores con alguno de los algoritmos.
400 UnsupportedFeature Está intentando llamar a una API que no es compatible, según su conjunto de características de modelado actual. Habilite la función de modelado correcta establecida en estándar o premium. Lista de los escenarios disponibles para cada conjunto de características.
401 Solicitud no autenticada Asegúrese de que su inquilino tenga permisos asignados para que el servicio funcione. Siga estos pasos para comprobar la autenticación.
408 RequestTimeout Se agotó el tiempo de espera de la solicitud. Intente volver a llamar a la solicitud de API.
429 RPS está por encima del nivel preasignado y corre el riesgo de ser limitado. Aumente la capacidad de RPS preasignada a un nivel superior o reduzca el RPS actual.
500 Error interno del servidor Se produjo un error de Intelligent Recommendations. Este problema puede ser temporal, así que vuelva a intentarlo después de un par de minutos. Consulte los registros o el informe de estado de modelado para ver si hay errores. Si el problema persiste sin registro de errores, contáctenos.
503 ServiceUnavailable El servicio no puede procesar la cuenta. Consulte los registros o el informe de estado de modelado para ver si hay errores. Si el problema persiste sin registro de errores, contáctenos.

Volver arriba

Consulte también

Intelligent Recommendations API
Guía de inicio rápido paraq llamar a la API
Errores comunes de inicio de sesión
Descripción general del contrato de datos