Wholesale Pricing i pozostałe metody API

Pobierz lub usuń pojedynczy rekord Wholesale Pricing według identyfikatora za pomocą publicznego API.

Ten dokument opisuje, jak pobierać i usuwać rekordy Wholesale Pricing za pomocą publicznego API.

Pobieranie rekordu Wholesale Pricing

1. Endpoint

Aby pobrać wybrany rekord Wholesale Pricing:

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

{id} to identyfikator rekordu Wholesale Pricing

Identyfikator można znaleźć w interfejsie aplikacji
Nie podawaj symbolu „#” przy użyciu identyfikatora

Przykład:

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

2. Nagłówki żądania

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

Nagłówek	Opis	Wymagany
`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 brakuje któregokolwiek z tych nagłówków, żądanie zostanie odrzucone.

3. Treść żądania

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

4. Odpowiedź API

Odpowiedzi z błędem

401 – Unauthorized

Ten błąd występuje, gdy uwierzytelnienie 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 – This action is unauthorized

Ten błąd występuje, gdy:

Klucz API nie ma uprawnienia View
Podany identyfikator 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

API GET wymaga uprawnienia View.

429 – Too Many Requests

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

Obowiązujące limity:

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

Odpowiedź w przypadku powodzenia

200 – API Success

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

Przykład:

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

Usuwanie rekordu Wholesale Pricing

1. Endpoint

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

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

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