Wholesale Pricing mit weiteren API-Methoden

Rufen Sie über die Public API einen einzelnen Wholesale-Pricing-Datensatz per ID ab oder löschen Sie ihn.

Dieses Dokument erklärt, wie Sie mit der Public API Wholesale Pricing-Datensätze abrufen und löschen.

Wholesale Pricing-Datensatz abrufen

1. Endpunkt

So rufen Sie einen bestimmten Wholesale Pricing-Datensatz ab:

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

{id} ist die ID des Wholesale Pricing-Datensatzes

Die ID finden Sie in der App-Oberfläche
Verwenden Sie die ID ohne das Zeichen „#“

Beispiel:

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

2. Request-Header

Alle GET-Anfragen müssen die folgenden Pflicht-Header enthalten:

Header	Beschreibung	Erforderlich
`X-SAMITA-API-KEY`	In der Wholesale-App bereitgestellter API-Schlüssel	Ja
`X-SAMITA-SHOP-URL`	Shopify-Shop-Domain im Format xxx.myshopify.com	Ja
`CONTENT-TYPE`	Muss `application/json` sein	Ja

Fehlt einer dieser Header, wird die Anfrage abgelehnt.

3. Request-Body

Die GET-API benötigt keinen Request-Body
Erforderlich ist nur der Parameter {id} in der URL

4. API-Antwort

Fehlerantworten

401 – Unauthorized

Dieser Fehler tritt auf, wenn die Authentifizierung fehlschlägt.

Mögliche Gründe:

Shop-URL fehlt
API-Schlüssel fehlt
Falsche Shop-URL
Falscher API-Schlüssel
API-Schlüssel passt nicht zum angegebenen Shop

403 – This action is unauthorized

Dieser Fehler tritt auf, wenn:

der API-Schlüssel keine Berechtigung View hat
die angegebene ID nicht existiert
der API-Schlüssel nicht über ausreichende Zugriffsrechte verfügt

Jedem API-Schlüssel können die folgenden Berechtigungen zugewiesen werden:

View
Create
Update
Delete

Die GET-API erfordert die Berechtigung View.

429 – Too Many Requests

Dieser Fehler tritt auf, wenn das Ratenlimit überschritten wird.

Aktuelle Limits:

Höchstens 1 Anfrage pro 5 Minuten
Höchstens 50 Anfragen pro Tag

Erfolgsantwort

200 – API Success

Die Anfrage ist gültig
Der Datensatz wurde erfolgreich abgerufen
Die Antwort wird im JSON-Format zurückgegeben

Beispiel:

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

Wholesale Pricing-Datensatz löschen

1. Endpunkt

So löschen Sie einen oder mehrere vorhandene Wholesale Pricing-Datensätze:

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

{id} in der URL sollte eine gültige Datensatz-ID sein, die API löscht aber tatsächlich die Datensätze, die im Parameter ids aufgeführt sind (siehe Request-Body unten) – nicht das URL-Segment.