Volume Pricing met andere API-methoden

Haal een enkel Volume Pricing-record op of verwijder het op ID met de Public API.

Dit document legt uit hoe je Volume Pricing-records ophaalt en verwijdert met de Public API.

Een Volume Pricing-record ophalen

1. Endpoint

Een specifiek Volume Pricing-record ophalen:

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

{id} is de ID van het Volume Pricing-record

Je vindt de ID in de interface van de app
Neem het symbool “#” niet op bij het gebruik van de ID

Voorbeeld:

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

2. Request headers

Alle GET-requests moeten de volgende vereiste headers bevatten:

Header	Beschrijving	Vereist
`X-SAMITA-API-KEY`	API-sleutel uit de Wholesale-app	Ja
`X-SAMITA-SHOP-URL`	Shopify-shopdomein in het formaat xxx.myshopify.com	Ja
`CONTENT-TYPE`	Moet `application/json` zijn	Ja

Als een van deze headers ontbreekt, wordt het request geweigerd.

3. Request body

De GET-API heeft geen request body nodig
Alleen de parameter {id} in de URL is vereist

4. API-response

Foutmeldingen

401 – Unauthorized

Deze fout treedt op als de authenticatie mislukt.

Mogelijke oorzaken:

Ontbrekende shop-URL
Ontbrekende API-sleutel
Onjuiste shop-URL
Onjuiste API-sleutel
API-sleutel komt niet overeen met de opgegeven shop

403 – This action is unauthorized

Deze fout treedt op als:

de API-sleutel geen machtiging View heeft
de opgegeven ID niet bestaat
de API-sleutel onvoldoende toegangsrechten heeft

Aan elke API-sleutel kunnen de volgende machtigingen worden toegewezen:

View
Create
Update
Delete

Voor de GET-API is de machtiging View nodig.

429 – Too Many Requests

Deze fout treedt op als de limiet voor het aantal requests is overschreden.

Huidige limieten:

Maximaal 1 request per 5 minuten
Maximaal 50 requests per dag

Succesvolle response

200 – API Success

Het request is geldig
Het record is succesvol opgehaald
De response wordt teruggegeven in JSON-formaat

Voorbeeld:

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

Een Volume Pricing-record verwijderen

1. Endpoint

Een of meer bestaande Volume Pricing-records verwijderen:

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

{id} in de URL moet een geldige record-ID zijn, maar de API verwijdert in werkelijkheid de records die in de parameter ids staan (zie Request body hieronder), niet het URL-segment.