Initialize guide ▶️

POST /navigation/guide/init
Api key

Initialize a new guided search.

A guided search will take several steps to go through, thus it is identified by a search_id which must be provided at each step.

The search_id holds all user choices made at each step of the guide.

For advanced usages, it is possible to provide some filters at search init, that will be used immediately on the rest of the search. The syntax of the filters requires some knowledged about the keys of the used properties and values and is not meant to be guessed without prior knowledge.

application/json

Body

  • optional_filters array[string]

    Optional filters that will reduce the product population to search into

  • custom_pictos_only boolean

    If enabled, will only show custom pictograms, not Deck default ones

Responses

  • 200 application/json

    Successfully initialized guided search

    Hide response attributes Show response attributes object
    • status string
    • result object

      Additional properties are allowed.

      Hide result attribute Show result attribute object
      • context object

        Additional properties are allowed.
POST /navigation/guide/init 
curl \
 -X POST https://api.ppe-analytics.com/api/v1/navigation/guide/init \
 -H "PPEApiKey: $API_KEY" \
 -H "Content-Type: application/json" \
 -d '{"optional_filters":["my-prop1~my-value","other-prop2~other-value"],"custom_pictos_only":true}'
Request examples 
{
  "optional_filters": [
    "my-prop1~my-value",
    "other-prop2~other-value"
  ],
  "custom_pictos_only": true
}
Response examples (200) 
{
  "status": "OK",
  "result": {
    "context": {
      "step": 1,
      "locale": "en",
      "search_id": "2e254ef2-3e63-4cb2-9680-3876b68e7191",
      "product_count": 4513,
      "api_follow_guide": "/api/v1/navigation/guide/2e254ef2-3e63-4cb2-9680-3876b68e7191/en/follow/current",
      "api_guide_results": "/api/v1/navigation/guide/2e254ef2-3e63-4cb2-9680-3876b68e7191/en/results",
      "custom_pictos_only": true
    }
  }
}