Pedidos de API de amostra
Este artigo mostra alguns exemplos de pedidos de API e respostas associadas. Cada exemplo mostra um cenário de recomendações base juntamente com outras caraterísticas de modificação de respostas, tais como filtragem, paginação, seleção de um algoritmo alternativo e muito mais. Se quiser experimentar estes exemplos no ponto final do Intelligent Recommendations, certifique-se de que substitui o nome do ponto final (parte DNS) e ajuste os parâmetros aos dados.
Nota
O parâmetro de contagem controlará o número de itens devolvidos em cada resposta. Os exemplos terão a contagem definida como 5 para maior claridade e brevidade. Para mais informações sobre formas de construir os seus pedidos de API, consulte API do Intelligent Recommendations e Guia de início rápido para chamar a API.
Exemplos
Eis alguns exemplos que poderá testar com a sua conta do Intelligent Recommendations:
- Obter Novos Itens
- Obter Itens Populares
- Obter Itens Semelhantes
- Obter Seleções do Utilizador
- Melhor Ação Seguinte (Carrinho)
- Identificação de Metadados e Criação de Registo de Utilizadores
- Como utilizar o parâmetro AlgoType
- Como utilizar o parâmetro Afinações
- Códigos de Estado da API
Caso se depare com erros ao testar respostas, consulte Registos de erros.
Obter novos itens
A API de Novos Itens devolve uma lista de produtos ordenados por data de lançamento.
O pedido de API tem o seguinte aspeto:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/New?modeling=adw&Count=5
Uma resposta com sucesso tem o seguinte aspeto:
{
"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"
}
Obter novos itens enquanto salta os 3 principais
Pode saltar itens numa lista anexando "SkipItems" ao pedido.
O pedido de API tem o seguinte aspeto:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/New?modeling=adw&Count=5&SkipItems=3
Uma resposta com sucesso tem o seguinte aspeto:
{
"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"
}
Obter itens populares
A API de Obter Itens Populares devolve uma lista de itens ordenados por contagem de interações, tais como transação, compra, vista, seleção ou transferência. Independentemente do que significar uma interação de item-utilizador no seu negócio, o primeiro item na lista é o que tem mais interações e os restantes são ordenados por ordem decrescente.
O pedido de API tem o seguinte aspeto:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Popular?modeling=adw&Count=5
Uma resposta com sucesso tem o seguinte aspeto:
{
"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"
}
Obter itens populares numa categoria específica
Pode definir categorias na entidade de dados ItemCategories. Para mais informações, consulte Descrição geral do contrato de dados.
O pedido de API quando pesquisa pelos itens de vestuário mais populares têm o seguinte aspeto:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Popular?modeling=adw&Count=5&Category=Clothing
Uma resposta com sucesso tem o seguinte aspeto:
{
"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"
}
Obter itens populares numa categoria específica com um filtro discreto
Pode definir filtros na entidade de dados ItemAndVariantFilters. Para mais informações, consulte Descrição geral do contrato de dados.
O pedido de API tem o seguinte aspeto:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Popular?modeling=adw&Count=5&Category=Clothing&Size=S
Uma resposta com sucesso tem o seguinte aspeto:
{
"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"
}
Obter itens populares numa categoria específica ao filtrar por um intervalo de valores
Para mais informações sobre a sintaxe de filtragem por intervalo, consulte o guia para filtros de intervalo.
O pedido de API tem o seguinte aspeto:
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
Uma resposta com sucesso tem o seguinte aspeto:
{
"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"
}
Obter itens semelhantes
A API de Itens Semelhantes fornece recomendações contextuais com base em itens de propagação específicos. O item de propagação é o ponto central em que as sugestões de produto se irão basear. O pedido de API dado para ID de Item de propagação segue imediatamente Semelhante/. Por exemplo, um item de propagação de camisola às riscas tem sugestões de produto diferentes quando comparado com um casaco de fato para homem.
O pedido de API tem o seguinte aspeto:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Similar/64702?modeling=adw&Count=5
Uma resposta com sucesso tem o seguinte aspeto:
{
"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"
}
Obter itens semelhantes com ordenação aleatória
Para impedir que os utilizadores vejam as mesmas recomendações uma e outra vez, o Intelligent Recommendations tem uma caraterística de ordenação aleatória ponderada que altera ligeiramente a ordem dos itens sem afetar significativamente a relevância. Os resultados podem ser ordenados aleatoriamente adicionando o refinamento enableshuffling. Poder saber mais sobre afinações e os seus diferentes tipos aqui.
O pedido de API tem o seguinte aspeto:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Similar/64702?modeling=adw&Count=5&Refinements=EnableShuffling
Uma resposta com sucesso tem o seguinte aspeto:
{
"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"
}
Personalizar
Este pedido de API pega numa imagem composta e devolve uma lista de itens recomendados visualmente semelhantes aos itens listados na imagem composta. Uma imagem composta e o respetivo mapeamento de itemIds podem ser configurados utilizando a Entidade de Dados de Imagem para Item aqui.
O pedido de API tem este aspeto para uma determinada imagem composta (642):
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Similar/642?AlgoType=BringSimilarItems
Uma resposta com sucesso tem o seguinte aspeto:
{
"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"
}
Concluir estilos semelhantes
Este pedido da API pega num ID de item e devolve uma lista de IDs de imagens compostas que contêm o item ou que contêm outro item semelhante, em que a semelhança se baseia no estilo visual.
O pedido de API tem este aspeto para um determinado ID de item (64702):
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Similar/64702?AlgoType=CompleteSimilarStyles
Uma resposta com sucesso tem o seguinte aspeto:
{
"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"
}
Concluir itens semelhantes
Este pedido da API pega num ID de item, localiza imagens compostas que contêm o item ou um item visualmente semelhante e devolve uma lista de IDs de item extraídos dessas imagens compostas.
O pedido de API tem este aspeto para um determinado ID de item (64702):
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Similar/64702?AlgoType=CompleteSimilarItems
Uma resposta com sucesso tem o seguinte aspeto:
{
"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"
}
Obter seleções do utilizador
A API de Seleções devolve um conjunto personalizado de recomendações com base no histórico de interações de um determinado utilizador.
O pedido de API tem o seguinte aspeto:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Picks?modeling=adw&UserId=ID1644&Count=5
Uma resposta com sucesso tem o seguinte aspeto:
{
"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"
}
Obter seleções do utilizador com sessionId
A API de Seleções devolve recomendações personalizadas com base nas vistas atuais numa sessão, independentemente de o utilizador ser conhecido (com sessão iniciada) ou desconhecido (anónimo). O parâmetro sessionId identifica os produtos que um utilizador visualizou na respetiva sessão de navegação atual e a API devolve uma lista de recomendações com base na atividade de visualização recente do utilizador com sessão iniciada ou anónimo.
O pedido de API de Seleções modificado substitui o userId pelo sessionId e utiliza as "Vistas Recentes" de AlgoType, da seguinte forma:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/picks?SessionId=123&AlgoType=RecentViews.
Nota
O parâmetro SessionId deve ser utilizado num pedido de API Semelhante na sessão apresentada antes de chamar a API de seleções, caso contrário, as recomendações de atividade recente devolvem resultados vazios.
Quando utilizar a API de Semelhantes:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Similar/64702?SessionId=123
uma resposta bem-sucedida à seleção de uma atividade recente é a seguinte:
```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
Neste exemplo, o parâmetro SessionId foi adicionado ao pedido de API.
Melhor Ação Seguinte
O pedido da API devolve uma lista dos itens que são frequentemente comprados em conjunto com os itens de seed no carrinho de um utilizador (ou agrupados, quando não estão num cenário de carrinho de retalho).
O pedido de API para item de propagação único/ações é:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Cart/64702?AlgoType=DAS&modeling=adw&Count=5
O pedido de API para vários itens de propagação/açõ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
Uma resposta com êxito é:
{
"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"
}
Identificação de metadados e criação de registo de utilizadores
A implementação de identificação de metadados e de registo de utilizadores requer algumas configurações ao contrato de dados. Consulte o nosso Guia para identificação de metadados e registo de utilizadores para obter uma descrição geral de alterações ao contrato de dados e exemplos de API, incluindo um passo a passo de dois casos de utilização comuns que beneficiam da identificação de metadados e fornecem alguns exemplos com dados de demonstração para cada um.
- Para obter "itens mais populares para si" para utilizadores inativos. Para ver um exemplo, consulte a secção chamada "Obter os Itens Mais Populares para si para Utilizadores Frios".
- Para criar um mapa aprendido por um computador dos valores de metadados dos Utilizadores. Para ver um exemplo, consulte a secção com o título "Criar um mapa ML dos valores de metadados dos utilizadores".
Como utilizar o parâmetro AlgoType
A caraterística do Intelligent Recommendations oferece vários algoritmos para calcular recomendações em vários cenários. Se quiser utilizar um algoritmo específico que não seja o predefinição, pode utilizar o parâmetro AlgoType.
AlgoTypes de exemplo
Consulte a Tabela AlgoTypes para ver a lista completa de AlgoTypes atualmente suportados. Exemplos de AlgoTypes incluem:
| AlgoType | Definição | API suportada |
|---|---|---|
| RecentPurchases | As recomendações de seleções são calculadas com base nas compras mais recentes do utilizador. | Só está disponível com a API de Seleções do Utilizador. |
| elemento visual | As semelhanças entre itens são calculadas com base em semelhanças visuais de imagens de catálogo. | Só está disponível com a API de Semelhantes. |
| Textual | As semelhanças de itens são calculadas com base em semelhanças textuais (compreensão de linguagem) de descrições textuais de catálogo. | Só está disponível com a API de Semelhantes. |
Construir um pedido de API com AlgoType
O pedido de API para adicionar um Tipo de Algo a um pedido de API de seleções do utilizador tem o seguinte aspeto:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Picks?AlgoType=RecentPurchases&modeling=adw&UserId=ID1644&Count=5
Uma resposta com sucesso tem o seguinte aspeto:
{
"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"
}
Como utilizar o parâmetro Afinações
A caraterística do Intelligent Recommendations oferece vários comportamentos para calcular e devolver recomendações, mas, por vezes, é necessário pedir um comportamento diferente do predefinido para uma experiência de compra melhor. Por exemplo, apresentar recomendações apenas em itens não comprados ou impedir a repetição da mesma encomenda. O parâmetro Afinações pode ser utilizado nesses casos para obter o comportamento recomendado desejado.
Consulte a Tabela Afinações para ver a lista completa de afinações atualmente suportadas.
Construir um pedido de API com Afinações
Pode adicionar várias afinações separadas por vírgulas, desde que não se contradigam entre si. Um pedido de API de exemplo para adição de uma afinação à API Semelhante pode ser encontrado aqui.
Códigos de Estado da API
Segue-se uma lista completa dos códigos de estado da API, descrições e como resolver os erros:
| Código | Estado | Razão | Como resolver |
|---|---|---|---|
| 200 | Com êxito | O Pedido da API foi bem-sucedido. | N/A |
| 200 | EmptyResults | Existem recomendações para este item de seed (itemId), no entanto, todas foram todas filtradas. | O principal motivo para a filtragem é o facto de existirem dados associados aos itens no catálogo. Quando antecipar que determinados produtos serão devolvidos, é importante verificar as datas de disponibilidade dos mesmos e certificar-se de que estão corretamente configurados com as atribuições de filtragem adequadas, como categoria, canal, catálogo e disponibilidade. |
| 200 | DataDoesNotExist | O item de seed (itemId) não existe nos resultados. O itemId especificado pode estar em falta nos dados de entrada ou não tem dados suficientes para ter resultados calculados. | Verifique se o item: - É válido - Pertence ao canal correto - Tem interações/imagens/texto suficientes. Para obter mais informações, consulte o Guia de Formatação de Contratos de Dados. |
| 200 | WaitingForData | Quando um novo componente de modelação é criado, o cálculo pode demorar algum tempo e poderá não estar pronto para devolver os resultados. | Verifique os relatórios ou o relatório de estado de modelação para verificar se existem erros. Se, após 24 horas, o problema persistir sem o registo de erros, contacte-nos. |
| 400 | UnsupportedRequest | Um dos parâmetros da API tem um valor não suportado ou existe um outro problema com o pedido da API, tal como, um cenário não suportado ou desativado. | Verifique se o valor do cabeçalho é diferente do parâmetro real. Para exemplos de pedidos de API de trabalho, aceda à parte superior deste artigo. Os pedidos de API diferentes estão desativados, consoante o seu conjunto de funcionalidades de modelação esteja configurado como Padrão ou Premium. Também pode consultar o relatório de estado de modelação para verificar se existem erros com algum dos algoritmos. |
| 400 | UnsupportedFeature | Está a tentar chamar uma API que Não é suportada com base no seu conjunto de funcionalidades de Modelação atual. | Ative a funcionalidade de modelação correta definida como padrão ou premium. Lista dos cenários disponíveis para cada conjunto de funcionalidades. |
| 401 | Pedido não autenticado | Certifique-se de que o inquilino atribuiu permissões para o serviço funcionar. Siga estes passos para verificar a sua autenticação. | |
| 408 | RequestTimeout | O seu pedido excedeu o tempo limite. | Tente chamar o pedido de API de novo. |
| 429 | O RPS está acima do escalão pré-alocado e está em risco de ser limitado. | Aumente a capacidade de RPS pré-alocada para um escalão superior ou diminua o RPS atual. | |
| 500 | Erro interno do servidor | Ocorreu um erro no lado do Intelligent Recommendations. | Este problema pode ser temporário. Tente voltar dentro de alguns minutos. Verifique os relatórios ou o relatório de estado de modelação para verificar se existem erros. Se o problema persistir sem o registo de erros, contacte-nos. |
| 503 | ServiceUnavailable | O serviço não consegue processar a conta. | Verifique os relatórios ou o relatório de estado de modelação para verificar se existem erros. Se o problema persistir sem o registo de erros, contacte-nos. |
Consulte também
API Intelligent Recommendations
Guia de início rápido para chamar a API
Erros comuns de registo
Descrição geral do contrato de dados