Volume Pricing con altri metodi API

Recupera o elimina un singolo record Volume Pricing tramite ID con la Public API.

Questo documento spiega come recuperare ed eliminare record Volume Pricing con la Public API.

Recupera un record Volume Pricing

1. Endpoint

Per recuperare uno specifico record Volume Pricing:

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

{id} è l’ID del record Volume Pricing

L’ID si ottiene dall’interfaccia dell’app
Non includere il simbolo «#» quando usi l’ID

Esempio:

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

2. Intestazioni della richiesta

Tutte le richieste GET 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. Corpo della richiesta

L’API GET non richiede un corpo della richiesta
È richiesto 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 indicato 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 Volume Pricing",
  "status": true,
  "type": "quantity",
  "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,
      "duplicated": false,
      "variant_pricing": true,
      "from_qty": "0",
      "from_amount": "0",
      "to_qty": "10",
      "to_amount": "0",
      "discount_groups": [
        {
          "name": "all",
          "type": "percent",
          "value": "10"
        }
      ],
      "variants": [
        {
          "id": 46747346763943,
          "duplicated": false,
          "from_qty": "0",
          "from_amount": "0",
          "to_qty": "10",
          "to_amount": "0",
          "discount_groups": [
            {
              "name": "all",
              "type": "percent",
              "value": "10"
            }
          ]
        }
      ]
    }
  ],
  "apply_market": {
    "type": "all",
    "handle": []
  },
  "discount_method": "variant",
  "discount_groups": [
    {
      "from_qty": "0",
      "from_amount": "0",
      "to_qty": "10",
      "to_amount": "0",
      "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"
}

Elimina un record Volume Pricing

1. Endpoint

Per eliminare uno o più record Volume Pricing esistenti:

DELETE https://wholesale.samita.io/api/v1/volume-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.