Wholesale Pricing con altri metodi API

Questo documento spiega come recuperare ed eliminare i record Wholesale Pricing tramite l’API pubblica.

---

Recuperare un record Wholesale Pricing

1. Endpoint

Per recuperare un record Wholesale Pricing specifico:

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

• {id} è l’ID del record Wholesale Pricing

• L’ID si trova nell’interfaccia dell’app
• Non includere il simbolo «#» quando usi l’ID

Esempio:

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

---

2. Intestazioni della richiesta

Tutte le richieste GET devono includere le seguenti intestazioni obbligatorie:

Intestazione	Descrizione	Obbligatoria
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 anche una sola di queste intestazioni, la richiesta viene rifiutata.

---

3. Corpo della richiesta

• L’API GET non richiede un corpo della richiesta
• Serve solo il parametro {id} nell’URL

---

4. Risposta dell’API

Risposte di errore

401 – Unauthorized

Questo errore si verifica quando l’autenticazione non riesce.

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 l’autorizzazione View
• L’ID fornito non esiste
• I diritti di accesso della chiave API non sono sufficienti

A ogni chiave API possono essere assegnate le seguenti autorizzazioni:

• View
• Create
• Update
• Delete

L’API GET richiede l’autorizzazione View.

---

429 – Too Many Requests

Questo errore si verifica quando viene superato il limite di frequenza.

Limiti attuali:

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

---

Risposta di successo

200 – API Success

• La richiesta è valida
• Il record è stato recuperato correttamente
• La risposta viene restituita in formato JSON

Esempio:

{
  "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"
}

---

Eliminare un record Wholesale Pricing

1. Endpoint

Per eliminare uno o più record Wholesale Pricing esistenti:

DELETE https://wholesale.samita.io/api/v1/wholesale-pricings/{id}

• {id} nell’URL dovrebbe essere un ID di record valido, ma l’API elimina in realtà i record elencati nel parametro ids (vedi Corpo della richiesta più sotto), non il segmento dell’URL.

Esempio:

DELETE https://wholesale.samita.io/api/v1/wholesale-pricings/1

---

2. Intestazioni della richiesta

Tutte le richieste DELETE devono includere le seguenti intestazioni obbligatorie:

Intestazione	Descrizione	Obbligatoria
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ì

---

3. Corpo della richiesta

• Passa un parametro ids: un elenco di ID dei record da eliminare, separati da virgole (come parametro della query string o come campo del corpo JSON). Così puoi eliminare più record con una sola chiamata, ad esempio ids=1,2,3.
• Il parametro ids è obbligatorio: senza di esso non viene eliminato alcun record.
• Nell’URL dell’endpoint serve solo {id}

---

4. Risposta dell’API

Risposte di errore

401 – Unauthorized

Restituito quando l’autenticazione non riesce.

Possibili motivi:

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

---

403 – This action is unauthorized

Questo errore si verifica quando:

• La chiave API non ha l’autorizzazione Delete
• L’ID fornito non esiste
• La chiave API non ha diritti di accesso sufficienti

L’API DELETE richiede l’autorizzazione Delete.

---

429 – Too Many Requests

Restituito quando la richiesta supera il limite di frequenza consentito.

Limiti di frequenza:

Tipo di limite	Valore
Frequenza delle richieste	1 richiesta ogni 5 minuti
Limite giornaliero	50 richieste al giorno

---

Risposta di successo

200 – API Success

• Il record Wholesale Pricing è stato eliminato correttamente
• Può essere restituito nessun contenuto oppure un messaggio di conferma

Esempio:

{
  "success": true
}