# Получение списка рекомендаций
## Описание метода

Осуществляется с помощью POST-запроса. Название операции можно получить в системе Майндбокс. Подробней про вызов метода можно прочитать [здесь](https://developers.mindbox.ru/docs/v3).  
Также возможен синхронный вызов с [Javascript SDK](https://developers.mindbox.ru/docs/%D1%82%D1%80%D0%B5%D0%BA%D0%B5%D1%80)

```xml title="Пример запроса"
POST https://api.mindbox.ru/v3/operations/sync?endpointId={уникальный идентификатор сайта/мобильного приложения/и т.п.}&operation={название операции}&deviceUUID={UUID устройства}

Content-Type: application/xml; charset=utf-8
Accept: application/xml
User-Agent: {User-Agent устройства клиента}
X-Customer-IP: {IP адрес клиента}

<operation>
  <recommendation>
    <limit>{Максимальное количество результатов}</limit>
    <area>
      <ids>
        <externalId>{Внешний идентификатор зоны}</externalId>
      </ids>
    </area>
  </recommendation>
</operation>
```

* Максимальное количество результатов - 30

* **Area** необязательна. Если не указана, выбираются продукты из зоны клиента, либо общего фида, если зона клиента не определена.

* **deviceUUID** может быть необязательным параметром в зависимости от настроек операции

* В запросе на рекомендации продукт к продукту (Похожие, Сопутствующие и т.д.) необходимо передавать только **offer_id**.

## Пример запроса операции

<Tabs defaultValue="1" className="w-full">
  <ScrollArea className="w-full">
    <TabsList className="flex w-max gap-2">
      <TabsTrigger value="1">Популярные продукты в категории</TabsTrigger>
      <TabsTrigger value="2">Персональные рекомендации</TabsTrigger>
      <TabsTrigger value="3">Сопутствующие продукты</TabsTrigger>
      <TabsTrigger value="4">Популярные продукты</TabsTrigger>
      <TabsTrigger value="5">Похожие продукты</TabsTrigger>
    </TabsList>
    <ScrollBar orientation="horizontal" />
  </ScrollArea>
  
  <TabsContent value="1">
  ```xml 
POST https://api.mindbox.cloud/v3/operations/sync?endpointId=Mindboxru&operation=Categorypopularproducts&deviceUUID=c0acc2bc-c52f-4157-9a26-9703825e7f7a

Accept: application/xml
Content-Type: application/xml

<operation>
  <recommendation>
    <limit>50</limit>
    <area>
      <ids>
        <externalId>34572</externalId>
      </ids>
    </area>
    <productCategory>
      <ids>
        <demowebsite>78</demowebsite>
      </ids>
    </productCategory>
  </recommendation>
</operation>
```
  </TabsContent>
  <TabsContent value="2">
  ```xml 
POST https://api.mindbox.cloud/v3/operations/sync?endpointId=Mindboxru&operation=RealtimePersonalRecommendations&deviceUUID=c0acc2bc-c52f-4157-9a26-9703825e7f7a

Accept: application/xml
Content-Type: application/xml

<operation>
  <recommendation>
    <limit>10</limit>
    <area>
      <ids>
        <externalId>1746</externalId>
      </ids>
    </area>
  </recommendation>
</operation>
```
  </TabsContent>
  <TabsContent value="3">
	```xml 
POST https://api.mindbox.cloud/v3/operations/sync?endpointId=Mindboxru&operation=Relatedproducts

Accept: application/xml
Content-Type: application/xml

<operation>
  <recommendation>
    <limit>10</limit>
    <product>
      <ids>
        <demowebsite>45321</demowebsite>
      </ids>
    </product>
  </recommendation>
</operation>
```
  </TabsContent>
  <TabsContent value="4">
  ```xml 
POST https://api.mindbox.cloud/v3/operations/sync?endpointId=Mindboxru&operation=PopularProducts&deviceUUID=c0acc2bc-c52f-4157-9a26-9703825e7f7a

Accept: application/xml
Content-Type: application/xml

<operation>
  <recommendation>
    <limit>10</limit>
    <area>
      <ids>
        <externalId>1746</externalId>
      </ids>
    </area>
  </recommendation>
</operation>
```
  </TabsContent>
  <TabsContent value="5">
  ```xml 
POST https://api.mindbox.cloud/v3/operations/sync?endpointId=Mindboxru&operation=Similarproducts

Accept: application/xml
Content-Type: application/xml

<operation>
  <recommendation>
    <limit>10</limit>
    <product>
      <ids>
        <demowebsite>45321</demowebsite>
      </ids>
    </product>
  </recommendation>
</operation>
```
</TabsContent>
</Tabs>

## Ответ

```xml title="Пример ответа"
<result>
  <status>Success</status>
  <recommendations>
    <recommendation>
      <name>Drink (297533)</name>
      <description>aH2Ff</description>
      <displayName>Icecream</displayName>
      <url>http://oyfuhgss.com/igrgspxuu?yqhtfk=avrXU&amp;nbrhtst=53Ln</url>
      <pictureUrl>http://udlwf.com/heca?ezjbvy=VAzJ&amp;bheca=AsFGA</pictureUrl>
      <price>13572156.48</price>
      <oldPrice>2688629.14</oldPrice>
      <ids>
        <mindboxId>996849070</mindboxId>
        <demowebsite>761954132</demowebsite>
      </ids>
      <manufacturer>
        <name>4eTCNaDXGuV</name>
      </manufacturer>
    </recommendation>
    <recommendation>
      <name>Drink (297533)</name>
      <description>aH2Ff</description>
      <displayName>Icecream</displayName>
      <url>http://oyfuhgss.com/igrgspxuu?yqhtfk=avrXU&amp;nbrhtst=53Ln</url>
      <pictureUrl>http://udlwf.com/heca?ezjbvy=VAzJ&amp;bheca=AsFGA</pictureUrl>
      <price>13572156.48</price>
      <oldPrice>2688629.14</oldPrice>
      <ids>
        <mindboxId>996849070</mindboxId>
        <demowebsite>761954132</demowebsite>
      </ids>
      <manufacturer>
        <name>4eTCNaDXGuV</name>
      </manufacturer>
    </recommendation>
  </recommendations>
</result>
```

* **name** - технический параметр для совместимости. Для отображения названия продукта используйте **displayName**