Getting Recommendations List

Method Description

Invoked with a POST request. Recommendation scenario name and input parameters can be set up via Maestra framework.

POST https://api.maestra.io/v3/operations/sync?endpointId={unique ID of site/mobile app/etc.}&operation={operation name}

Content-Type: application/xml; charset=utf-8
Accept: application/xml

<operation>
  <recommendation>
    <limit>{Maximum number of results}</limit>
    <area>
      <ids>
        <externalId>{Area external ID}</externalId>
      </ids>
    </area>
  </recommendation>
</operation>

Maximum number of results — 30
Area is Optional

Sample Operations

POST https://api.maestra.io/v3/operations/sync?endpointId=Maestra&operation=Reco

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

<operation>
  <recommendation>
    <limit>10</limit>
    <area>
      <ids>
        <externalId>1746</externalId>
      </ids>
    </area>
  </recommendation>
</operation>

POST https://api.maestra.io/v3/operations/sync?endpointId=Maestra&operation=Reco

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

<operation>
  <recommendation>
    <limit>50</limit>
    <area>
      <ids>
        <externalId>34572</externalId>
      </ids>
    </area>
    <productCategory>
      <ids>
        <website>78</website>
      </ids>
    </productCategory>
  </recommendation>
</operation>

POST https://api.maestra.io/v3/operations/sync?endpointId=Maestra&operation=Reco

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

<operation>
  <recommendation>
    <limit>10</limit>
    <product>
      <ids>
        <website>45321</website>
      </ids>
    </product>
  </recommendation>
</operation>

POST https://api.maestra.io/v3/operations/sync?endpointId=Maestra&operation=Reco

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

<operation>
  <recommendation>
    <limit>10</limit>
    <product>
      <ids>
        <website>45321</website>
      </ids>
    </product>
  </recommendation>
</operation>

POST https://api.maestra.io/v3/operations/sync?endpointId=Maestra&operation=Reco

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

<operation>
  <recommendation>
    <limit>10</limit>
    <area>
      <ids>
        <externalId>1746</externalId>
      </ids>
    </area>
  </recommendation>
</operation>

Sample Response

<result>
  <status>Success</status>
  <recommendations>
    <recommendation>
      <name>Drink (297533)</name>
      <description>3mvf9</description>
      <displayName>Icecream</displayName>
      <url>http://xgir.com/edxnu?njdhebs=jtaCNQ7Y&amp;niskmyhns=8yd9WmtuEAk</url>
      <pictureUrl>http://xgsvh.com/fdcnc?ufhoreji=dLiDnKKi&amp;fxpqybcqbu=m8FUD</pictureUrl>
      <price>4600071.02</price>
      <oldPrice>12076659.12</oldPrice>
      <category>Odd2AB</category>
      <vendorCode>XLdOnqUcc</vendorCode>
      <ids>
        <productId>283600377</productId>
      </ids>
      <manufacturer>
        <name>fFyleP4N</name>
      </manufacturer>
    </recommendation>
    <recommendation>
      <name>Drink (297533)</name>
      <description>3mvf9</description>
      <displayName>Icecream</displayName>
      <url>http://xgir.com/edxnu?njdhebs=jtaCNQ7Y&amp;niskmyhns=8yd9WmtuEAk</url>
      <pictureUrl>http://xgsvh.com/fdcnc?ufhoreji=dLiDnKKi&amp;fxpqybcqbu=m8FUD</pictureUrl>
      <price>4600071.02</price>
      <oldPrice>12076659.12</oldPrice>
      <category>Odd2AB</category>
      <vendorCode>XLdOnqUcc</vendorCode>
      <ids>
        <productId>283600377</productId>
      </ids>
      <manufacturer>
        <name>fFyleP4N</name>
      </manufacturer>
    </recommendation>
  </recommendations>
</result>