API per Wholesale Pricing

Questo documento descrive come usare la Public API per recuperare l’elenco dei record Wholesale Pricing dall’applicazione Samita Wholesale.

---

1. Endpoint

Per recuperare l’elenco Wholesale Pricing, usa il seguente endpoint API:

GET - https://wholesale.samita.io/api/v1/wholesale-pricings

---

2. Intestazioni della richiesta

Tutte le richieste API devono includere le seguenti intestazioni obbligatorie:

Header	Descrizione	Obbligatorio
X-SAMITA-API-KEY	Chiave API fornita nell’app Wholesale	Sì
X-SAMITA-SHOP-URL	Dominio del negozio Shopify nel formato xxx.myshopify.com	Sì
CONTENT-TYPE	Deve essere application/json	Sì

Se manca una di queste intestazioni, la richiesta viene rifiutata.

---

3. Parametri della richiesta (query / body)

Per personalizzare la richiesta API puoi includere i seguenti parametri:

Parametro	Descrizione	Obbligatorio
limit	Definisce il numero massimo di record restituiti in una richiesta	No
query	Usato per cercare i record per titolo o ID	No
status	Usato per filtrare i record per stato	No
sort	Usato per ordinare i record in base alla data di creazione	No

a. limit

• Definisce il numero massimo di record restituiti in una richiesta
• Deve essere un valore numerico
• Valore minimo: 1
• Valore massimo: 20
• Parametro facoltativo
• Se lasciato vuoto, il valore predefinito è 20

Esempio:

limit=10

---

b. query

• Usato per cercare i record per titolo o ID
• Deve essere un valore stringa
• Lunghezza massima: 255 caratteri
• Parametro facoltativo

Esempio:

query=pricing rule

---

c. status

• Usato per filtrare i record per stato
• Parametro facoltativo
• Se lasciato vuoto, l’API restituisce tutti i record
• Se indicato, sono accettati solo i seguenti valori:

Valore	Descrizione
active	Solo i record attivi
draft	Solo i record in bozza

Qualsiasi altro valore viene rifiutato.

Esempio:

status=active

---

d. sort

• Usato per ordinare i record in base alla data di creazione
• Parametro facoltativo
• Se lasciato vuoto, i record sono ordinati dal più recente al meno recente
• Sono accettati solo due valori:

Valore	Descrizione
descrease	Ordina dal più recente al meno recente
ascrease	Ordina dal meno recente al più recente

Esempio:

sort=descrease

---

Esempio di richiesta:

GET /wholesale-pricing?page=1&limit=20&status=active&sort=descrease

4. Risposta dell’API

L’API restituisce uno dei seguenti codici di stato HTTP:

a. Risposte di errore

401 – Unauthorized

Questo errore si verifica quando la richiesta non è autenticata correttamente.

Possibili motivi:

• URL del negozio mancante
• Chiave API mancante
• URL del negozio errato
• Chiave API errata
• La chiave API non corrisponde al negozio indicato

---

403 – This action is unauthorized

Questo errore si verifica quando la chiave API non ha autorizzazioni sufficienti.

A ogni chiave API possono essere assegnate le seguenti autorizzazioni:

• View
• Create
• Update
• Delete

La Wholesale Pricing List API richiede l’autorizzazione View.
Se la chiave API non ha l’autorizzazione View, viene restituito questo errore.

---

429 – Too Many Requests

Questo errore si verifica quando la richiesta supera il limite di frequenza consentito.

Limiti di frequenza attuali:

• Massimo 1 richiesta ogni 5 minuti
• Massimo 50 richieste al giorno

Se questi limiti vengono superati, il sistema restituisce questo errore.

---

b. Risposta di successo

200 – API Success

• La richiesta è valida
• L’autenticazione è riuscita
• I dati vengono restituiti correttamente
• L’elenco Wholesale Pricing viene fornito in formato JSON

---

Esempio di risposta di successo dell’API:

[
  {
    "id": 1,
    "title": "New Wholesale Pricing",
    "status": true,
    "apply_customer": {
      "type": "all",
      "tags": []
    },
    "exclude_customer": {
      "type": "none",
      "tags": []
    },
    "apply_product": {
      "type": "all",
      "product_ids": [],
      "product_tags": [],
      "collection_ids": [],
      "apply_for_variants": false
    },
    "exclude_product": {
      "type": "none",
      "product_ids": [],
      "collection_ids": []
    },
    "discount_for_variants": [
      {
        "id": 8516448190631,
        "variant_pricing": true,
        "variants": [
          {
            "id": 46747346763943,
            "discount_groups": [
              {
                "name": "all",
                "type": "percent",
                "value": "10"
              }
            ]
          }
        ]
      }
    ],
    "apply_market": {
      "type": "all",
      "handle": []
    },
    "discount_group": {
      "type": "percent",
      "value": "10"
    },
    "active_date": {
      "types": [],
      "start_at": "",
      "end_at": ""
    },
    "created_at": "2026-01-15T10:00:00",
    "updated_at": "2026-01-15T10:00:00"
  }
]