Jeśli zarządzasz cenami hurtowymi poza WordPress, możesz wykonać większość z nich przez HTTP zamiast w panelu administracyjnym. API Wholesale Suite rozszerza WooCommerce REST API, dzięki czemu możesz odczytywać i zapisywać produkty hurtowe, warianty, role, rabaty i analizy z własnego kodu. Ten artykuł wymienia, co obejmuje każda grupa punktów końcowych, która wtyczka ją zapewnia i gdzie znaleźć pełne odniesienie.
Wymagania
- WooCommerce Wholesale Prices 1.12 lub nowszy. Punkty końcowe wsadowe wymagają wersji 1.16 lub nowszej.
- Punkty końcowe produktów hurtowych, wariantów i ról są dostarczane z WooCommerce Wholesale Prices, darmową wtyczką. Nie potrzebujesz WooCommerce Wholesale Prices Premium do ich obsługi.
- WooCommerce Wholesale Prices Premium 1.27 lub nowszy, dla punktów końcowych rabatów hurtowych. API Premium pojawiło się w wersji 1.25, a punkty końcowe rabatów kategorii i ogólnych pojawiły się w wersji 1.27. Punkty końcowe analityczne również wymagają wersji Premium.
- WooCommerce Wholesale Lead Capture 2.0 lub nowszy, dla punktów końcowych leadów.
Wholesale Suite wprowadza dedykowane punkty końcowe: wholesale/v1/ i wwlc/v1. Punkty te zapewniają elastyczność w programowym interakcji i zarządzaniu kluczowymi aspektami Twojego sklepu hurtowego.
Kluczowe funkcje API Wholesale Suite
- Produkty hurtowe: listuj, twórz, aktualizuj lub usuwaj produkty hurtowe. Aktualizuj wiele naraz za pomocą punktu końcowego wsadowego, wholesale/v1/products/batch, który wymaga WooCommerce Wholesale Prices 1.16 lub nowszej.
- Warianty hurtowe: listuj, twórz, aktualizuj lub usuwaj warianty produktu. Punkt końcowy wsadowy to wholesale/v1/products/{product_id}/variations/batch.
- Role hurtowe: listuj i aktualizuj role, które kontrolują, kto otrzymuje jakie ceny. Darmowa wtyczka zawiera jedną rolę hurtową, a wersja Premium dodaje tworzenie i usuwanie.
- Leady hurtowe: listuj, twórz, aktualizuj lub usuwaj leady hurtowe. Te punkty końcowe są dostarczane z WooCommerce Wholesale Lead Capture i używają przestrzeni nazw wwlc/v1.
- Rabat hurtowy: odczytuj i ustawiaj rabaty na poziomie kategorii i rabaty ogólne za pomocą punktów końcowych category-discount i general-discount. Wymagają one WooCommerce Wholesale Prices Premium 1.27 lub nowszej.
- Analizy hurtowe: pobieraj metryki sprzedaży hurtowej dla produktów, klientów lub ogólnych zakupów hurtowych. Znajdują się one we własnej przestrzeni nazw, wholesale/v1/analytics, i wymagają wersji Premium.
Dlaczego warto korzystać z API Wholesale Suite
Ta integracja API sprawia, że zarządzanie Twoim sklepem hurtowym jest bardziej elastyczne i płynne, zwłaszcza jeśli potrzebujesz zautomatyzować lub zsynchronizować swoje dane hurtowe z innymi systemami lub platformami. Niezależnie od tego, czy zarządzasz dużymi katalogami, masowo dostosowujesz ceny, czy personalizujesz role użytkowników, to API pozwala Ci zrobić to wszystko bez konieczności ręcznego dostosowywania każdego ustawienia w panelu administracyjnym.
Rozpoczęcie pracy z API Wholesale Suite
Aby korzystać z API Wholesale Suite, użyj Uwierzytelniania WordPress REST API i standardowych czasowników HTTP (GET, POST, PUT, DELETE). Możesz zintegrować tę funkcjonalność z dowolną platformą lub systemem, który obsługuje żądania API oparte na HTTP.
Aby uzyskać szczegółowe informacje na temat korzystania z API Wholesale Suite, w tym dostępne metody, parametry i przykładowe żądania, zapoznaj się z pełną dokumentacją API.
Lista dozwolonych akcji wyzwalanych przez REST API
Wholesale Suite ma drugi punkt końcowy do wykonywania akcji konserwacyjnych, takich jak czyszczenie pamięci podręcznej produktów. Znajduje się on w przestrzeni nazw wwp/v1, a nie wholesale/v1, więc łatwo go przeoczyć.
Wyślij żądanie POST do /wp-json/wwp/v1/admin/action z wartością action w treści. Żądanie wymaga dostępu administratora.
Każda nazwa akcji musi znajdować się na białej liście. Jeśli tak nie jest, odpowiedź wraca ze statusem error i komunikatem Invalid action. Dozwolona akcja uruchamia swój program obsługi i zwraca status oraz komunikat.
Te nazwy akcji są dostępne, gdy pasująca wtyczka jest aktywna:
- WooCommerce Wholesale Prices Premium: clear_var_prod_price_range_caching, clear_product_caching, clear_unused_product_meta, initialize_product_visibility_meta, force_fetch_update_data
- WooCommerce Wholesale Lead Capture: force_fetch_update_data, create_lead_pages
- WooCommerce Wholesale Order Form: schedule_database_optimization
Aby dodać własną akcję, zarejestruj ją za pomocą filtru wwp_allowed_trigger_actions w PHP. Wholesale Suite odbiera również wszelkie haki, których nazwa zaczyna się od wwp_trigger_ i traktuje resztę nazwy jako dozwoloną akcję. Nie można dodać nazwy akcji za pośrednictwem samego interfejsu REST API.
add_filter( 'wwp_allowed_trigger_actions', function ( $actions ) {
$actions[] = 'my_custom_action';
return $actions;
} );
add_filter( 'wwp_trigger_my_custom_action', function ( $params ) {
// Run your task here.
return array(
'status' => 'success',
'message' => 'Custom action finished.',
);
} );Istnieje druga, oddzielna biała lista dla akcji ustawień grup. Wykorzystuje ona filtr wwp_allowed_group_actions i działa w punkcie końcowym zapisu ustawień, /wp-json/wwp/v1/admin/save. Jeśli Twoja akcja zapisuje ustawienia, powinna znaleźć się na tej liście.
Pomoc i wsparcie
Mamy dedykowany zespół wsparcia dla Wholesale Suite, który bardzo dobrze zna nasze produkty, WooCommerce i branżę. Zapraszamy do korzystania z ich wiedzy w dowolnym momencie, na całym świecie.
Jeśli jesteś obecnym klientem, przejdź do formularza zgłoszenia zgłoszenia pomocy technicznej i wyślij nam wiadomość.
Jeśli korzystasz z darmowego wtyczki, wyślij nam prośbę o pomoc na forum. Aktywnie monitorujemy fora pomocy technicznej WordPress.org dla darmowej wtyczki i pomagamy naszym użytkownikom tam najlepiej, jak potrafimy.
