Make Full Text Search and return found Documents

GET /V1/search

Make Full Text Search and return found Documents

Query parameters

  • searchCriteria[requestName] string
  • searchCriteria[filterGroups][0][filters][0][field] string

    Field

  • searchCriteria[filterGroups][0][filters][0][value] string

    Value

  • searchCriteria[filterGroups][0][filters][0][conditionType] string

    Condition type

  • searchCriteria[sortOrders][0][field] string

    Sorting field.

  • searchCriteria[sortOrders][0][direction] string

    Sorting direction.

  • searchCriteria[pageSize] integer

    Page size.

  • searchCriteria[currentPage] integer

    Current page.

Responses

  • 200 Success.

    Hide response attributes Show response attributes object
    • items array[object] Required
      Hide items attributes Show items attributes object

      Interface Search Document

      • id integer Required
      • custom_attributes array[object]

        Custom attributes values.

        Hide custom_attributes attributes Show custom_attributes attributes object

        Interface for custom attribute value.

        • attribute_code string Required

          Attribute code

        • value string Required

          Attribute value

    • aggregations object Required

      Interface Aggregation to get faceted data

      Hide aggregations attributes Show aggregations attributes object
      • buckets array[object] Required

        All Document fields

        Hide buckets attributes Show buckets attributes object

        Interface for facet Bucket

        • name string Required

          Field name

        • values array[object] Required

          Field values

          Hide values attributes Show values attributes object

          Interface Aggregation Value

          • value string Required

            Aggregation

          • metrics array[string] Required

            Metrics

      • bucket_names array[string] Required

        Document field names

    • search_criteria object Required

      Interface SearchCriteriaInterface

      Hide search_criteria attributes Show search_criteria attributes object
      • request_name string Required
      • filter_groups array[object] Required

        A list of filter groups.

        Hide filter_groups attribute Show filter_groups attribute object

        Groups two or more filters together using a logical OR

        • filters array[object]

          A list of filters in this group

          Hide filters attributes Show filters attributes object

          Filter which can be used by any methods from service layer.

          • field string Required

            Field

          • value string Required

            Value

          • condition_type string

            Condition type

      • sort_orders array[object]

        Sort order.

        Hide sort_orders attributes Show sort_orders attributes object

        Data object for sort order.

        • field string Required

          Sorting field.

        • direction string Required

          Sorting direction.

      • page_size integer

        Page size.

      • current_page integer

        Current page.

    • total_count integer Required

      Total count.

    Hide response attributes Show response attributes object
    • items array[object] Required
      Hide items attributes Show items attributes object

      Interface Search Document

      • id integer Required
      • custom_attributes array[object]

        Custom attributes values.

        Hide custom_attributes attributes Show custom_attributes attributes object

        Interface for custom attribute value.

        • attribute_code string Required

          Attribute code

        • value string Required

          Attribute value

    • aggregations object Required

      Interface Aggregation to get faceted data

      Hide aggregations attributes Show aggregations attributes object
      • buckets array[object] Required

        All Document fields

        Hide buckets attributes Show buckets attributes object

        Interface for facet Bucket

        • name string Required

          Field name

        • values array[object] Required

          Field values

          Hide values attributes Show values attributes object

          Interface Aggregation Value

          • value string Required

            Aggregation

          • metrics array[string] Required

            Metrics

      • bucket_names array[string] Required

        Document field names

    • search_criteria object Required

      Interface SearchCriteriaInterface

      Hide search_criteria attributes Show search_criteria attributes object
      • request_name string Required
      • filter_groups array[object] Required

        A list of filter groups.

        Hide filter_groups attribute Show filter_groups attribute object

        Groups two or more filters together using a logical OR

        • filters array[object]

          A list of filters in this group

          Hide filters attributes Show filters attributes object

          Filter which can be used by any methods from service layer.

          • field string Required

            Field

          • value string Required

            Value

          • condition_type string

            Condition type

      • sort_orders array[object]

        Sort order.

        Hide sort_orders attributes Show sort_orders attributes object

        Data object for sort order.

        • field string Required

          Sorting field.

        • direction string Required

          Sorting direction.

      • page_size integer

        Page size.

      • current_page integer

        Current page.

    • total_count integer Required

      Total count.

  • Unexpected error

    Hide response attributes Show response attributes object
    • message string Required

      Error message

    • errors array[object]

      Errors list

      Hide errors attributes Show errors attributes object

      Error details

      • message string

        Error message

      • parameters array[object]

        Error parameters list

        Hide parameters attributes Show parameters attributes object

        Error parameters item

        • resources string

          ACL resource

        • fieldName string

          Missing or invalid field name

        • fieldValue string

          Incorrect field value

    • code integer

      Error code

    • parameters array[object]

      Error parameters list

      Hide parameters attributes Show parameters attributes object

      Error parameters item

      • resources string

        ACL resource

      • fieldName string

        Missing or invalid field name

      • fieldValue string

        Incorrect field value

    • trace string

      Stack trace

    Hide response attributes Show response attributes object
    • message string Required

      Error message

    • errors array[object]

      Errors list

      Hide errors attributes Show errors attributes object

      Error details

      • message string

        Error message

      • parameters array[object]

        Error parameters list

        Hide parameters attributes Show parameters attributes object

        Error parameters item

        • resources string

          ACL resource

        • fieldName string

          Missing or invalid field name

        • fieldValue string

          Incorrect field value

    • code integer

      Error code

    • parameters array[object]

      Error parameters list

      Hide parameters attributes Show parameters attributes object

      Error parameters item

      • resources string

        ACL resource

      • fieldName string

        Missing or invalid field name

      • fieldValue string

        Incorrect field value

    • trace string

      Stack trace

GET /V1/search
curl \
 --request GET 'https://magento2.winkelstraat.mac/rest/all/V1/search'
Response examples (200)
{
  "items": [
    {
      "id": 42,
      "custom_attributes": [
        {
          "attribute_code": "string",
          "value": "string"
        }
      ]
    }
  ],
  "aggregations": {
    "buckets": [
      {
        "name": "string",
        "values": [
          {
            "value": "string",
            "metrics": [
              "string"
            ]
          }
        ]
      }
    ],
    "bucket_names": [
      "string"
    ]
  },
  "search_criteria": {
    "request_name": "string",
    "filter_groups": [
      {
        "filters": [
          {
            "field": "string",
            "value": "string",
            "condition_type": "string"
          }
        ]
      }
    ],
    "sort_orders": [
      {
        "field": "string",
        "direction": "string"
      }
    ],
    "page_size": 42,
    "current_page": 42
  },
  "total_count": 42
}
Response examples (200)
<?xml version="1.0" encoding="UTF-8"?>
<root>
  <items type="array">
    <item>
      <id type="integer">42</id>
      <custom-attributes type="array">
        <custom-attribute>
          <attribute-code>string</attribute-code>
          <value>string</value>
        </custom-attribute>
      </custom-attributes>
    </item>
  </items>
  <aggregations>
    <buckets type="array">
      <bucket>
        <name>string</name>
        <values type="array">
          <value>
            <value>string</value>
            <metrics type="array">
              <metric>string</metric>
            </metrics>
          </value>
        </values>
      </bucket>
    </buckets>
    <bucket-names type="array">
      <bucket-name>string</bucket-name>
    </bucket-names>
  </aggregations>
  <search-criteria>
    <request-name>string</request-name>
    <filter-groups type="array">
      <filter-group>
        <filters type="array">
          <filter>
            <field>string</field>
            <value>string</value>
            <condition-type>string</condition-type>
          </filter>
        </filters>
      </filter-group>
    </filter-groups>
    <sort-orders type="array">
      <sort-order>
        <field>string</field>
        <direction>string</direction>
      </sort-order>
    </sort-orders>
    <page-size type="integer">42</page-size>
    <current-page type="integer">42</current-page>
  </search-criteria>
  <total-count type="integer">42</total-count>
</root>
Response examples (default)
{
  "message": "string",
  "errors": [
    {
      "message": "string",
      "parameters": [
        {
          "resources": "string",
          "fieldName": "string",
          "fieldValue": "string"
        }
      ]
    }
  ],
  "code": 42,
  "parameters": [
    {
      "resources": "string",
      "fieldName": "string",
      "fieldValue": "string"
    }
  ],
  "trace": "string"
}
Response examples (default)
<?xml version="1.0" encoding="UTF-8"?>
<root>
  <message>string</message>
  <errors type="array">
    <error>
      <message>string</message>
      <parameters type="array">
        <parameter>
          <resources>string</resources>
          <fieldName>string</fieldName>
          <fieldValue>string</fieldValue>
        </parameter>
      </parameters>
    </error>
  </errors>
  <code type="integer">42</code>
  <parameters type="array">
    <parameter>
      <resources>string</resources>
      <fieldName>string</fieldName>
      <fieldValue>string</fieldValue>
    </parameter>
  </parameters>
  <trace>string</trace>
</root>