Volume Pricing i pozostałe metody API

Pobierz lub usuń pojedynczy rekord Volume Pricing według ID za pomocą publicznego interfejsu API.

W tym dokumencie wyjaśniono, jak pobierać i usuwać rekordy Volume Pricing za pomocą publicznego interfejsu API.

Pobieranie rekordu Volume Pricing

1. Punkt końcowy

Aby pobrać konkretny rekord Volume Pricing:

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

{id} to ID rekordu Volume Pricing

ID można znaleźć w interfejsie aplikacji
Nie dodawaj symbolu „#” przy użyciu ID

Przykład:

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

2. Nagłówki żądania

Wszystkie żądania GET muszą zawierać następujące wymagane nagłówki:

Nagłówek	Opis	Wymagane
`X-SAMITA-API-KEY`	Klucz API dostępny w aplikacji Wholesale	Tak
`X-SAMITA-SHOP-URL`	Domena sklepu Shopify w formacie xxx.myshopify.com	Tak
`CONTENT-TYPE`	Musi mieć wartość `application/json`	Tak

Jeśli którykolwiek z tych nagłówków jest nieobecny, żądanie zostanie odrzucone.

3. Treść żądania

Interfejs GET API nie wymaga treści żądania
Wymagany jest tylko parametr {id} w adresie URL

4. Odpowiedź API

Odpowiedzi z błędem

401 – Brak autoryzacji

Ten błąd występuje, gdy uwierzytelnianie się nie powiedzie.

Możliwe przyczyny:

Brak adresu URL sklepu
Brak klucza API
Nieprawidłowy adres URL sklepu
Nieprawidłowy klucz API
Klucz API nie pasuje do podanego sklepu

403 – Ta akcja jest nieautoryzowana

Ten błąd występuje, gdy:

Klucz API nie ma uprawnienia View
Podane ID nie istnieje
Klucz API ma niewystarczające prawa dostępu

Każdemu kluczowi API można przypisać następujące uprawnienia:

View
Create
Update
Delete

Interfejs GET API wymaga uprawnienia View.

429 – Zbyt wiele żądań

Ten błąd występuje po przekroczeniu limitu żądań.

Aktualne limity:

Maksymalnie 1 żądanie na 5 minut
Maksymalnie 50 żądań dziennie

Odpowiedź pozytywna

200 – Sukces API

Żądanie jest prawidłowe
Rekord został pomyślnie pobrany
Odpowiedź jest zwracana w formacie JSON

Przykład:

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

Usuwanie rekordu Volume Pricing

1. Punkt końcowy

Aby usunąć jeden lub więcej istniejących rekordów Volume Pricing:

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

{id} w adresie URL powinno być prawidłowym ID rekordu, ale API faktycznie usuwa rekordy wymienione w parametrze ids (zobacz Treść żądania poniżej) – a nie segment adresu URL.