Wholesale Pricing met andere API-methoden

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

In dit document lees je hoe je Wholesale Pricing-records ophaalt en verwijdert met de Public API.

Een Wholesale Pricing-record ophalen

1. Endpoint

Een specifiek Wholesale Pricing-record ophalen:

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

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

Je vindt de ID in de app-interface
Neem het teken “#” niet op wanneer je de ID gebruikt

Voorbeeld:

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

2. Request-headers

Alle GET-verzoeken 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 de notatie xxx.myshopify.com	Ja
`CONTENT-TYPE`	Moet `application/json` zijn	Ja

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

3. Request body

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

4. API-respons

Foutresponsen

401 – Unauthorized

Deze fout treedt op wanneer de authenticatie mislukt.

Mogelijke oorzaken:

Shop-URL ontbreekt
API-sleutel ontbreekt
Onjuiste shop-URL
Onjuiste API-sleutel
API-sleutel hoort niet bij de opgegeven shop

403 – This action is unauthorized

Deze fout treedt op wanneer:

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

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

View
Create
Update
Delete

Voor de GET-API is het recht View vereist.

429 – Too Many Requests

Deze fout treedt op wanneer de limiet voor het aantal verzoeken is overschreden.

Huidige limieten:

Maximaal 1 verzoek per 5 minuten
Maximaal 50 verzoeken per dag

Succesrespons

200 – API Success

Het verzoek is geldig
Het record is opgehaald
De respons wordt teruggegeven in JSON-indeling

Voorbeeld:

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

Een Wholesale Pricing-record verwijderen

1. Endpoint

Een of meer bestaande Wholesale Pricing-records verwijderen:

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