# Chapter 8 - Advanced use

**Table of content**

* [Chapter 8 - Advanced use](#Chapter8-Advanceduse-Chapter8-Advanceduse)
  * [Rendering Options](#Chapter8-Advanceduse-RenderingOptions)
    * [Include all fields from the "products" resource](#include-all-fields-from-the-products-resource)
    * [Include only the ID of all carriers](#Chapter8-Advanceduse-IncludeonlytheIDofallcarriers)
    * [Only include the "name" and "value" fields from the "configurations" resource](#only-include-the-name-and-value-fields-from-the-configurations-resource)
  * [Rendering Filters](#rendering-filters)
    * [Only include the first and last names of customers "customers" whose ids are 1 or 5](#only-include-the-first-and-last-names-of-customers-customers-whose-ids-are-1-or-5)
    * [Only include the last names of customers "customers" whose ids are between 1 and 10](#only-include-the-last-names-of-customers-customers-whose-ids-are-between-1-and-10)
    * [Only include the birthday of clients whose name is "John" and whose last name is "Doe"](#only-include-the-birthday-of-clients-whose-name-is-john-and-whose-last-name-is-doe)
    * [Only include the names of manufacturers "manufacturers" whose name begins with "Appl"](#only-include-the-names-of-manufacturers-manufacturers-whose-name-begins-with-appl)
  * [Sorting Filters](#sorting-filters)
    * [Filter the customers "customers" in alphabetical order according to last name](#filter-the-customers-customers-in-alphabetical-order-according-to-last-name)
  * [Filters to limit rendering](#filters-to-limit-rendering)
    * [Only include the first 5 states "states"](#only-include-the-first-5-states-states)
    * [Only include the first 5 elements starting from the 10th element from the states resource "states"](#only-include-the-first-5-elements-starting-from-the-10th-element-from-the-states-resource-states)

## Chapter 8 - Advanced use <a href="#chapter8-advanceduse-chapter8-advanceduse" id="chapter8-advanceduse-chapter8-advanceduse"></a>

Here are a few sample advanced uses.<br>

### Rendering Options <a href="#chapter8-advanceduse-renderingoptions" id="chapter8-advanceduse-renderingoptions"></a>

#### Include all fields from the "products" resource

URL: (Store URL)/api/products/?display=full

PHP:

```
$opt = array(
	'resource' => 'products', 
	'display'  => 'full'
);
```

#### Include only the ID of all carriers <a href="#chapter8-advanceduse-includeonlytheidofallcarriers" id="chapter8-advanceduse-includeonlytheidofallcarriers"></a>

URL: (Store URL)/api/carriers/?display=\[id]

PHP :

```
$opt = array('resource' => 'carriers', 'display' => '[id]');
```

#### Only include the "name" and "value" fields from the "configurations" resource

URL: (Store URL)/api/configurations/?display=\[name,value]

PHP:

```
$opt = array(
	'resource' => 'configurations', 
	'display'  => '[name,value]'
);
```

### Rendering Filters

#### Only include the first and last names of customers "customers" whose ids are 1 or 5

URL: (Store URL)/api/customers/?display=\[firstname,lastname]\&filter\[id]=\[1|5]

PHP:

```
$opt = array(
	'resource'   => 'customers', 
	'display'    => '[firstname,lastname]', 
	'filter[id]' => '[1|5]'
);
```

#### Only include the last names of customers "customers" whose ids are between 1 and 10

URL: (Store URL)/api/customers/?display=\[lastname]\&filter\[id]=\[1,10]

PHP:

```
$opt = array(
	'resource'   =>'customers', 
	'display'    => '[lastname]', 
	'filter[id]' => '[1,10]'
);
```

#### Only include the birthday of clients whose name is "John" and whose last name is "Doe"

URL: (Store URL)/api/customers/?display=\[birthday]\&filter\[firstname]=\[John]\&filter\[lastname]=\[DOE]

PHP:

```
$opt = array(
	'resource'          =>'customers', 
	'display'           => '[birthday]', 
	'filter[firstname]' => '[John]', 
	'filter[lastname]'  => '[DOE]'
);
```

#### Only include the names of manufacturers "manufacturers" whose name begins with "Appl"

URL: (Store URL)/api/manufacturers/?display=\[name]\&filter\[name]=\[appl]%

PHP:

```
$opt = array(
	'resource'     => 'manufacturers', 
	'display'      => '[name]', 
	'filter[name]' => '[appl]%'
);
```

### Sorting Filters

#### Filter the customers "customers" in alphabetical order according to last name

URL: Store URL/api/customers?display=full\&sort=\[lastname\_ASC]

PHP:

```
$opt = array(
	'resource' => 'customers', 
	'display'  => 'full', 
	'sort'     => '[lastname_ASC]'
);
```

### Filters to limit rendering

#### Only include the first 5 states "states"

URL: (Store URL)/api/states/?display=full\&limit=5

PHP:

```
$opt = array(
	'resource' => 'states', 
	'display'  => 'full', 
	'limit'    => '5'
);
```

#### Only include the first 5 elements starting from the 10th element from the states resource "states"

URL: (Store URL)/api/states/?display=full\&limit=9,5

PHP:

```
$opt = array(
	'resource' => 'states', 
	'display'  => 'full', 
	'limit'    => '9,5'
);
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.prestashop-project.org/1-6-documentation/english-documentation/developer-guide/developer-tutorials/using-the-prestashop-web-service/web-service-tutorial/chapter-8-advanced-use.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.