Solicitações de API de exemplo
Este artigo mostra alguns exemplos de solicitações de API e as respostas associadas. Cada exemplo mostra um cenário de recomendações básicas junto com outros recursos de modificação de resposta, como filtragem, paginação, seleção de um algoritmo alternativo e muito mais. Se você quiser testar esses exemplos no seu ponto de extremidade do Recomendações Inteligentes, substitua o nome do ponto de extremidade (parte DNS) e ajuste os parâmetros para os seus dados.
Observação
O parâmetro count controla o número de itens retornados em cada resposta. Os exemplos terão a contagem definida como 5 para maior clareza e brevidade. Para obter mais informações sobre maneiras de criar suas solicitações de API, consulte API do Recomendações Inteligentes e Guia de Início Rápido para chamar a API.
Exemplos
Veja alguns exemplos que você pode testar com sua conta do Recomendações Inteligentes:
- Obter novos itens
- Obter itens populares
- Obter itens semelhantes
- Obter escolhas do usuário
- Próxima melhor ação (carrinho)
- Marcação de Metadados e Particionamento de Usuários
- Como usar o parâmetro AlgoType
- Como usar o parâmetro Refinements
- Códigos de Status da API
Se você encontrar erros ao testar as respostas, consulte os Logs de erros.
Obter novos itens
A API New Items retorna uma lista de produtos ordenados por data de lançamento.
A solicitação de API tem a aparência a seguir:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/New?modeling=adw&Count=5
Uma resposta bem-sucedida tem a aparência a seguir:
{
"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 pulando os 3 primeiros
Você pode pular itens em uma lista anexando "SkipItems" à solicitação.
A solicitação de API tem a aparência a seguir:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/New?modeling=adw&Count=5&SkipItems=3
Uma resposta bem-sucedida tem a aparência a seguir:
{
"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 Get Popular Items retorna uma lista de itens ordenados por contagem de interações, como transação, compra, visualização, seleção ou download. Qualquer que seja o significado de uma interação usuário-item em sua empresa, o primeiro item da lista é aquele que tem mais interações, e os demais são ordenados em ordem decrescente.
A solicitação de API tem a aparência a seguir:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Popular?modeling=adw&Count=5
Uma resposta bem-sucedida tem a aparência a seguir:
{
"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 em uma categoria específica
Você pode definir categorias dentro da entidade de dados ItemCategories. Para obter mais informações, consulte Visão geral do contrato de dados.
A solicitação da API ao pesquisar os itens de vestuário mais populares tem esta aparência:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Popular?modeling=adw&Count=5&Category=Clothing
Uma resposta bem-sucedida tem a aparência a seguir:
{
"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 em uma categoria específica com um filtro discreto
Você pode definir filtros dentro da entidade de dados ItemAndVariantFilters. Para obter mais informações, consulte Visão geral do contrato de dados.
A solicitação de API tem a aparência a seguir:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Popular?modeling=adw&Count=5&Category=Clothing&Size=S
Uma resposta bem-sucedida tem a aparência a seguir:
{
"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 em uma categoria específica filtrando por um intervalo de valores
Para obter mais informações sobre a sintaxe de filtragem por intervalo, consulte o Guia para filtros de intervalo.
A solicitação de API tem a aparência a seguir:
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 bem-sucedida tem a aparência a seguir:
{
"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 Similar Items fornece recomendações contextuais com base em itens de propagação específicos. O item de propagação é o ponto de pivô no qual as sugestões de produtos serão baseadas. A solicitação de API fornecida para a ID do item de propagação segue imediatamente Similar/. Por exemplo, um item de propagação de suéter listrado tem sugestões de produtos distintos quando comparado a um paletó masculino.
A solicitação de API tem a aparência a seguir:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Similar/64702?modeling=adw&Count=5
Uma resposta bem-sucedida tem a aparência a seguir:
{
"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 embaralhamento
Para evitar que os usuários vejam as mesmas recomendações repetidamente, o Recomendações Inteligentes tem um recurso de embaralhamento ponderado que altera ligeiramente a ordem dos itens sem afetar significativamente a relevância. Os resultados podem ser embaralhados adicionando o refinamento enableshuffling. Você pode saber mais sobre refinamentos e os diferentes tipos aqui.
A solicitação de API tem a aparência a seguir:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Similar/64702?modeling=adw&Count=5&Refinements=EnableShuffling
Uma resposta bem-sucedida tem a aparência a seguir:
{
"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"
}
Traga o Visual
Essa solicitação de API pega uma imagem composta e retorna uma lista de itens recomendados que são visualmente semelhantes aos itens listados na imagem composta. Uma imagem composta e seu mapeamento de itemIds podem ser configurados usando a Entidade de dados de imagem para item aqui..
A solicitação de API tem essa aparência para uma determinada imagem composta (642):
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Similar/642?AlgoType=BringSimilarItems
Uma resposta bem-sucedida tem a aparência a seguir:
{
"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
Essa solicitação de API pega um ID de item e retorna uma lista de IDs de imagens compostas que contêm o item ou contêm itens semelhantes diferentes, em que a semelhança é baseada no estilo visual.
A solicitação de API tem essa aparência para um determinado ID de item (64702):
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Similar/64702?AlgoType=CompleteSimilarStyles
Uma resposta bem-sucedida tem a aparência a seguir:
{
"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
Essa solicitação de API pega um ID de item, localiza imagens compostas que contêm o item ou um item visualmente semelhante e retorna uma lista de IDs de itens extraídos dessas imagens compostas.
A solicitação de API tem essa aparência para um determinado ID de item (64702):
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Similar/64702?AlgoType=CompleteSimilarItems
Uma resposta bem-sucedida tem a aparência a seguir:
{
"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 escolhas do usuário
A API Picks retorna um conjunto personalizado de recomendações com base no histórico de interações de um determinado usuário.
A solicitação de API tem a aparência a seguir:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Picks?modeling=adw&UserId=ID1644&Count=5
Uma resposta bem-sucedida tem a aparência a seguir:
{
"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 escolhas do usuário usando sessionId
A API de escolhas retorna recomendações personalizadas com base nas exibições atuais em uma sessão, independentemente de o usuário ser conhecido (conectado) ou desconhecido (anônimo). O parâmetro sessionId identifica os produtos que um usuário exibiu na sessão de navegação atual, e a API retorna uma lista de recomendações com base na atividade de exibição recente do usuário conectado ou anônimo.
A solicitação da API de escolhas modificada substitui a userId pela sessionId e usa o AlgoType "Exibições Recentes", fornecido conforme a seguir:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/picks?SessionId=123&AlgoType=RecentViews.
Observação
O parâmetro SessionId deve ser usado na solicitação API semelhante na sessão especificada antes de chamar a API de escolhas; caso contrário, as recomendações de atividades recentes retornam resultados vazios.
Ao usar a API semelhante:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Similar/64702?SessionId=123
uma resposta bem-sucedida de seleções de atividades recentes é 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"
}
Observação
O parâmetro SessionId foi adicionado à solicitação de API neste exemplo.
Próxima melhor ação
A solicitação de API retorna uma lista de itens que são comprados com mais frequência junto com os itens de propagação no carrinho de um usuário (ou combinados, quando não em um cenário de carrinho de varejo).
A solicitação de API para ações/itens de propagação única é:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Cart/64702?AlgoType=DAS&modeling=adw&Count=5
A solicitação de API para ações/itens de propagação múltipla é:
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 bem-sucedida é:
{
"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"
}
Marcação de metadados e particionamento de usuários
A implementação da marcação de metadados e do agrupamento de usuários requer algumas configurações no contrato de dados. Consulte nosso Guia para marcação de metadados e particionamento de usuários para obter uma visão geral das alterações de contrato de dados e exemplos de API, incluindo uma explicação passo a passo de dois casos de uso comuns que se beneficiam da marcação de metadados e fornece alguns exemplos com dados de demonstração para cada um.
- Para obter "itens mais populares para você" para usuários frios. Para ver um exemplo, consulte a seção chamada "Obter os itens mais populares para usuários frios".
- Para criar um mapa com machine learning dos valores de metadados dos usuários. Para ver um exemplo, consulte a seção chamada "Criar um mapa de ML dos valores de metadados dos usuários".
Como usar o parâmetro AlgoType
O recurso Recomendações Inteligentes tem vários algoritmos para calcular recomendações em diversos cenários. Caso queira usar um algoritmo específico diferente do padrão, você pode utilizar o parâmetro AlgoType.
Exemplo de AlgoTypes
Confira a Tabela AlgoTypes para ver a lista completa de AlgoTypes suportados atualmente. Os exemplos de AlgoTypes incluem:
| AlgoType | Definição | API compatível |
|---|---|---|
| RecentPurchases | As recomendações de sugestões são calculadas com base nas compras mais recentes do usuário. | Disponível apenas com a API de escolhas do usuário. |
| Elemento visual | As semelhanças dos itens são calculadas com base nas semelhanças visuais das imagens do catálogo. | Disponível apenas com a API semelhante. |
| Textual | As semelhanças dos itens são calculadas com base nas semelhanças textuais (reconhecimento de linguagem) das descrições textuais do catálogo. | Disponível apenas com a API semelhante. |
Criar uma solicitação de API com AlgoType
A solicitação de API para adicionar um tipo de algoritmo com o objetivo de obter as escolhas do usuário tem esta aparência:
https://ir-example.mir.prod.reco.microsoft.com/Reco/V1.0/Picks?AlgoType=RecentPurchases&modeling=adw&UserId=ID1644&Count=5
Uma resposta bem-sucedida tem a aparência a seguir:
{
"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 usar o parâmetro Refinements
O recurso Recomendações Inteligentes tem vários comportamentos para calcular e gerar recomendações, mas às vezes é necessário solicitar um comportamento diferente do padrão para ter uma melhor experiência de compra. Por exemplo, exibir recomendações apenas em itens não comprados ou impedir a repetição do mesmo pedido. O parâmetro Refinements pode ser utilizado nesses casos para ter o comportamento de recomendação desejado.
Confira a Tabela Refinements para ver a lista completa dos refinamentos compatíveis atualmente.
Criar uma solicitação de API com Refinements
É possível adicionar vários refinamentos separados por vírgula, desde que não sejam contraditórios. Um exemplo de solicitação de API para adicionar um refinamento à API semelhante pode ser encontrado aqui.
Códigos de Status da API
Uma lista completa de códigos de status de API, descrições e como resolver erros é a seguinte:
| Code | Status | Motivo | Como resolver |
|---|---|---|---|
| 200 | Êxito | A Solicitação da API foi bem-sucedida. | N/A |
| 200 | EmptyResults | Existem recomendações para este item de propagação (itemId), no entanto, todas foram filtradas. | O principal motivo da filtragem são os dados associados aos itens do catálogo. Ao antecipar a devolução de determinados produtos, é importante verificar as datas de disponibilidade e garantir que estejam configurados corretamente com as atribuições de filtragem pertinentes, como categoria, canal, catálogo e disponibilidade. |
| 200 | DataDoesNotExist | O item de propagação (itemId) não existe nos resultados. O itemId especificado pode estar faltando nos dados de entrada ou não tem dados suficientes para ter resultados calculados. | Verifique se o item: - é válido - pertence ao canal certo - Tem interações/imagens/texto suficientes. Para mais informações, consulte as Diretrizes de Formatação de Contrato de Dados. |
| 200 | WaitingForData | Quando um novo componente de modelagem é criado, o cálculo pode levar algum tempo e pode não estar pronto para retornar resultados. | Verifique os logs ou o relatório de status de modelagem para ver se há erros. Se após 24 horas o problema persistir sem registro de erros, entre em contato conosco. |
| 400 | UnsupportedRequest | Um dos parâmetros da API tem um valor incompatível ou há outro problema com a solicitação da API, como: um cenário incompatível ou desativado. | Verifique se o valor do cabeçalho é diferente do parâmetro real. Para ver exemplos de solicitações de API em funcionamento, vá para o início deste artigo. Diferentes solicitações de API são desativadas dependendo se seu conjunto de recursos de modelagem está configurado como Standard ou Premium. Você também pode verificar o relatório de status de modelagem para ver se há erros com algum dos algoritmos. |
| 400 | UnsupportedFeature | Você está tentando chamar uma API sem suporte com base em seu conjunto de recursos de Modelagem atual. | Ative o recurso de modelagem correto definido como padrão ou premium. Lista de quais cenários estão disponíveis para cada conjunto de recursos. |
| 401 | Solicitação não autenticada | Certifique-se de que seu locatário tenha atribuído permissões para o serviço operar. Siga estas etapas para verificar sua autenticação | |
| 408 | RequestTimeout | Sua solicitação atingiu o tempo limite. | Tente chamar a solicitação de API novamente. |
| 429 | O RPS está acima do nível pré-alocado e corre o risco de ser limitado. | Aumente a capacidade de RPS pré-alocada para um nível superior ou diminua o RPS atual. | |
| 500 | Erro interno do servidor | Ocorreu um erro no lado das Recomendações Inteligentes. | Esse problema pode ser temporário, então tente novamente após alguns minutos. Verifique os logs ou o relatório de status de modelagem para ver se há erros. Se o problema persistir sem registro de erros, entre em contato conosco. |
| 503 | ServiceUnavailable | O serviço não é capaz de processar a conta. | Verifique os logs ou o relatório de status de modelagem para ver se há erros. Se o problema persistir sem registro de erros, entre em contato conosco. |
Confira também
API de Recomendações Inteligentes
Guia de início rápido para chamar a API
Erros comuns de registro
Visão geral do contrato de dados