---
agentTools:
  projectIndex: https://store360.readme.io/llms.txt
---

# Recupero prodotti - GET

## Recupero Prodotti

### Metodo HTTP

`GET`

***

## Endpoint

```
https://MIOSERVER/store360_api
```

***

## Risorse

### Recupero lista prodotti

```
GET /products
```

Esempio:

```
https://MIOSERVER/store360_api/products
```

Questa risorsa consente il recupero di **più prodotti** e supporta **parametri di paginazione tramite query string**.

***

### Recupero singolo prodotto

```
GET /products/{codice_prodotto_store360}
```

Esempio:

```
https://MIOSERVER/store360_api/products/ST23FGX01
```

In questo caso, il `codice_prodotto_store360` è un **Path Parameter** e identifica in modo univoco il prodotto da recuperare. La ricerca è **esatta**: `GET /products/ABC1` non restituisce `ABC10`.

***

## Path Parameters

Utilizzati **esclusivamente** per il recupero del singolo prodotto.

### `codice_prodotto_store360`

* **Tipo:** string
* **Descrizione:** Codice univoco del prodotto nel sistema Store360 (campo `codice` della risposta)

***

## Query Parameters

Utilizzati **solo nel recupero di più prodotti** (`GET /products`) e passati tramite **query string**.

Tutti i parametri sono **opzionali**.

***

### `per_pagina`

* **Tipo:** integer
* **Default:** `100`
* **Descrizione:** Numero di prodotti restituiti per pagina

***

### `pagina`

* **Tipo:** integer
* **Default:** `1`
* **Descrizione:** Numero della pagina corrente

***

## Paginazione

La paginazione avviene tramite i parametri `pagina` e `per_pagina`.

Esempio:

```
GET /products?pagina=2&per_pagina=200
```

La richiesta precedente restituisce i prodotti **dal 201 al 400**.

***

## Comportamento di Default

* Se non vengono specificati parametri di paginazione:
  * `pagina = 1`
  * `per_pagina = 100`
* Vengono restituiti solo i prodotti **attivi** e associati ad almeno una categoria, **una riga per prodotto**, ordinati per `products_id`
* Una pagina oltre l’ultima risponde `Ack: "KO"` con `CodiceErrore: "600"`
* Nel recupero del singolo prodotto, se il codice non esiste (o il prodotto non è attivo) risponde `Ack: "KO"` con `CodiceErrore: "600"`

***

## Esempi di Richiesta

### Recupero prodotti con paginazione

```
GET /products?pagina=2&per_pagina=200
```

### Recupero singolo prodotto

```
GET /products/ST23FGX01
```

## Esempio di risposta JSON Prodotti

```json
{
  "ResponseTo": "Products",
  "Timestamp": "1765637484",
  "Ack": "OK",
  "MessaggioErrore": "",
  "CodiceErrore": "",
  "Output": {
    "TotaleProdotti": "3",
    "TotalePagine": "1",
    "PaginaCorrente": "1",
    "ProdottiPerPagina": "100",
    "Prodotti": [
      {
        "codice": "711-7509",
        "products_id": "14",
        "codice_padre": "PR_711",
        "varianti": {
          "Colore": "NERO",
          "Taglia": "35/36"
        },
        "products_name": "Ciabatta donna Mare Guess GU111A1U2",
        "products_description": "",
        "products_barcode": "7618391082685",
        "MPN": "",
        "codice_categoria": "beachwear donna#accessori mare donna",
        "ecommerce_price": "24.90",
        "amazon_price": "26.00",
        "ebay_price": "",
        "products_image": "https://example.store360.it/prodotti/immagini/5563.jpg",
        "products_quantity": "0",
        "manufacturers_name": "Guess",
        "products_status": "1"
      },
      {
        "codice": "711-7505",
        "products_id": "1674",
        "codice_padre": "PR_711",
        "varianti": {
          "Colore": "ORCHIDEA",
          "Taglia": "35/36"
        },
        "products_name": "Ciabatta donna Mare Guess GU111A1U2",
        "products_description": "",
        "products_barcode": "7618391082685",
        "MPN": "",
        "codice_categoria": "beachwear donna#accessori mare donna",
        "ecommerce_price": "24.90",
        "amazon_price": "26.00",
        "ebay_price": "",
        "products_image": "https://example.store360.it/prodotti/immagini/5563.jpg",
        "products_quantity": "0",
        "manufacturers_name": "Guess",
        "products_status": "1"
      },
      {
        "codice": "711-7511",
        "products_id": "1679",
        "codice_padre": "PR_711",
        "varianti": {
          "Colore": "NERO",
          "Taglia": "39/40"
        },
        "products_name": "Ciabatta donna Mare Guess GU111A1U2",
        "products_description": "",
        "products_barcode": "7618391082685",
        "MPN": "",
        "codice_categoria": "beachwear donna#accessori mare donna",
        "ecommerce_price": "24.90",
        "amazon_price": "",
        "ebay_price": "25.50",
        "products_image": "https://example.store360.it/prodotti/immagini/5563.jpg",
        "products_quantity": "1",
        "manufacturers_name": "Guess",
        "products_status": "1"
      }
    ]
  }
}
```

Il significato di ogni campo è descritto in **Dettaglio array Prodotto**.