Prosty przewodnik po API WooCommerce

Nie ma wątpliwości, że WordPress sprawił, że cały proces publikowania Twojej witryny jest łatwiejszy i prostszy niż na większości innych platform. Na dowód możesz po prostu spojrzeć na zdumiewające statystyki dotyczące wykorzystania rdzenia WordPress. Co więcej, WooCommerce zrobił to samo dla e-commerce, co WordPress dla publikowania w Internecie. Oprócz tego, że jest przyjazny dla początkujących, oferuje narzędzia przyjazne dla programistów, takie jak API WooCommerce do optymalizacji witryny.

W tym artykule przedstawimy WooCommerce REST API i porozmawiamy o jego związku z własnym API WordPressa. Omówimy również, dlaczego chcesz skorzystać z tej potężnej technologii i jak zacząć.

Wskoczmy od razu!

Przedstawiamy WooCommerce REST API

Interfejs API WooCommerce umożliwia wdrożenie niestandardowej funkcjonalności witryny na poziomie oprogramowania. Możesz kodować w sposób specjalnie zaprojektowany do integracji z WooCommerce. W związku z tym możesz stworzyć praktycznie dowolną funkcję lub funkcjonalność, jeśli masz czas, umiejętności i (potencjalnie) budżet.

Aby zrozumieć, jak działa ta kluczowa funkcja, zapoznaj się z dwoma terminami:

• Przeniesienie stanu przedstawicielskiego (REST). Jest to skomplikowany temat, ale na potrzeby tego artykułu REST jest rodzajem „usługi internetowej”, która umożliwia dostęp do określonych elementów strony internetowej.
• Interfejs programowania aplikacji (API). W przeciwieństwie do graficznego interfejsu użytkownika (GUI) jest to zasadniczo zestaw haków kodu i filtrów, które umożliwiają pracę z punktami dostępu. Ogólnie rzecz biorąc, zakodujesz je w określonych plikach opartych na WordPressie.

Innymi słowy, REST określa, do czego możesz uzyskać dostęp w swojej witrynie za pomocą kodu, a interfejs API zapewnia narzędzia do wykorzystania tego dostępu. Razem umożliwiają wprowadzenie znaczących zmian w działaniu witryny.

Jak WooCommerce API ma się do WordPress REST API

Kiedy został wprowadzony po raz pierwszy, API WooCommerce było pojedynczym podmiotem. Innymi słowy, został zaprojektowany wyłącznie do uzyskiwania dostępu do „punktów końcowych” WooCommerce i nie wpływał na żadne inne elementy WordPressa.

Jednak po wprowadzeniu interfejsu API REST WordPress, punkty końcowe WooCommerce zostały połączone, aby stworzyć jeden nadrzędny „przejdź do” dostępu do WordPressa pod maską. Mimo to nadal istnieje dokumentacja interfejsu API WooCommerce. Jeśli przeczytasz wprowadzenie do tego dokumentu, historia API jest szeroko nakreślona.

Na potrzeby tego artykułu uznamy „WooCommerce API” za zbiór określonych punktów końcowych dla tej platformy e-commerce. Oczywiście przydadzą się również podstawowe punkty końcowe, więc wymienimy też kilka z nich. Krótko mówiąc, najlepiej nie rozłączać się, próbując oddzielić te dwa interfejsy API — teraz są jednym i tym samym.

Dlaczego warto skorzystać z API WooCommerce

Być może już wiesz, dlaczego API REST WooCommerce jest ekscytującą i potężną strzałą w kołczanie Twojego sklepu. Oto tylko kilka powodów, dla których warto z niego skorzystać:

• Masz do zaimplementowania niestandardową funkcjonalność. Jeśli nie możesz znaleźć tego, czego potrzebujesz za pomocą wtyczek, motywów lub dodatkowych fragmentów kodu, rozwiązaniem może być samodzielne utworzenie funkcji.
• Klienci mogą otrzymać niestandardowy interfejs. Korzystając z szerszych funkcji interfejsu API REST WordPress, możesz oddzielić front-end swojej witryny od back-endu. Pozwala to wykorzystać moc WordPressa pod maską, jednocześnie tworząc układy i projekty stron w innym języku.
• Twój zespół może korzystać z niestandardowych zapleczy. Tak jak Twoi klienci mogą uzyskać wyjątkowe wrażenia z interfejsu użytkownika, możesz wykorzystać różne części WooCommerce, aby utworzyć niestandardowy pulpit nawigacyjny zaplecza. Możesz dołączyć prawie wszystkie metryki lub dane, które chcesz, tworząc własny interfejs użytkownika i platformę analityczną.

Niezależnie od powodów, WooCommerce API oferuje bardzo potężną funkcjonalność. Aby to dalej zademonstrować, spójrzmy na niektóre szczegóły tego interfejsu API i zobaczmy, gdzie i jak można go używać w Twojej witrynie.

Co możesz osiągnąć dzięki API WooCommerce (4 przykłady)

Kuszące jest powiedzenie „Wszystko jest możliwe”, jeśli chodzi o API WooCommerce. Warto jednak przyjrzeć się kilku typowym zadaniom, które możesz napotkać, wraz z kilkoma konkretnymi przypadkami użycia.

1. Twórz, aktualizuj i usuwaj produkty

Ponieważ produkty Twojego sklepu są siłą napędową Twojej firmy, API WooCommerce oferuje wiele opcji, aby zapewnić, że możesz nimi wszystkimi zarządzać. Możesz pracować z praktycznie każdą informacją zebraną w WooCommerce, chociaż niektóre punkty końcowe są tylko do odczytu. Istnieją nawet oddzielne interfejsy API dla pojedynczych produktów, odmian, atrybutów i ich warunków, taksonomii, klas wysyłkowych i recenzji.

Może się to przydać na wiele sposobów. Rozważmy na przykład witrynę marketplace, na której użytkownicy przesyłają własne produkty. Możesz utworzyć narzędzie do przesyłania frontonu, aby pomóc w wykonywaniu niezbędnych zadań administracyjnych na podstawie danych wejściowych użytkownika. Możesz także zbiorczo edytować wiele powiązanych recenzji produktów na podstawie żądania użytkownika, usuwać identyfikujące e-maile i wiele więcej.

2. Zlecenia procesowe i związane z nimi uwagi

Jeśli produkty są siłą napędową Twojego sklepu, zamówienia są paliwem rakietowym. W związku z tym API WooCommerce oferuje wiele pomocnych w administrowaniu zamówieniami i notatkami. Dostęp do praktycznie każdej właściwości znalezionej w WooCommerce, wraz z powiązanymi właściwościami rozliczeń, wysyłki i metadanych.

Twierdzimy, że większość zastosowań tego punktu końcowego będzie polegać na wyświetlaniu zamówień w jakiś sposób. Nawet prosty jednowierszowy fragment tekstu zapewnia ogromną moc. Na przykład listę można przeanalizować pod kątem wielu wzmianek o tym samym produkcie, uwzględnionych w zamówieniach, w których wielokoszyk zawierał określoną pozycję, i wiele więcej.

Zbiorcze aktualizowanie notatek o zamówieniach to kolejne pomocne zastosowanie tego aspektu interfejsu API. Zebranie kolekcji zamówień świątecznych, podzielenie ich na podstawie statusu każdego z nich i uporządkowanie wynikowego JSON w arkuszu kalkulacyjnym może pomóc w szybszym i bardziej wydajnym dostarczaniu zamówień.

3. Dostosuj stawki i klasy podatków

Podatki przyprawiają wielu właścicieli sklepów o ból głowy, zwłaszcza gdy mają do czynienia z zamówieniami międzynarodowymi. Ponieważ istnieje wiele różnych sposobów naliczania podatków według różnych stawek, interfejs API WooCommerce oferuje wiele opcji pracy z tymi danymi. Punkty końcowe są podzielone na dwa warianty:

• Stawki podatkowe: tutaj rejestrowana jest rzeczywista wartość procentowa wraz z innymi danymi identyfikacyjnymi.
• Klasy podatkowe: Są to szerokie zakresy podatków, do których stosuje się stawki.

Na przykład możesz utworzyć stawkę podatku 20%, która będzie stosowana do klasy „Stawka standardowa”. W rzeczywistości możliwość zbiorczego aktualizowania stawek podatkowych jest dobrym wykorzystaniem interfejsu API WooCommerce. Bardziej unikalnym przykładem może być konfiguracja, w której stawka lub klasa podatku jest tworzona na podstawie określonego atrybutu klienta. Jest to idealne rozwiązanie w sytuacjach, gdy trzeba „zakwalifikować” klienta przed jego zarejestrowaniem lub wysłaniem do procesu realizacji transakcji.

4. Ustaw strefy, lokalizacje i metody wysyłki

Jeśli kiedykolwiek próbowałeś pracować z wysyłką w WooCommerce, zrozumiesz, jakie to może być pole minowe. Jeśli pomylisz się z jakimś elementem, będzie to miało bezpośredni wpływ na klienta w obszarze, który jest gotowy na słabe opinie i recenzje. Na szczęście API WooCommerce może współpracować ze wszystkimi punktami końcowymi związanymi z wysyłką, takimi jak strefy, lokalizacje i metody.

W porównaniu z innymi aspektami interfejsu API nie ma tu zbyt wielu atrybutów, z którymi można pracować. Jednak nadal dostępnych jest wiele opcji, które pomogą Ci pracować z danymi Twojego sklepu. Chociaż często będziesz chciał „ustawić i zapomnieć” informacje o wysyłce (biorąc pod uwagę ich złożoność i wpływ na wrażenia użytkownika), nadal istnieje kilka praktycznych zastosowań.

Na przykład prawdopodobnie będziesz pamiętać o aktualnych przepisach dotyczących COVID-19 zarówno na poziomie stanowym, jak i ogólnokrajowym. Mając to na uwadze, możesz rozważyć użycie kombinacji punktów końcowych, aby tymczasowo ograniczyć wysyłkę do określonych lokalizacji. Ponadto możesz powiadomić użytkowników o wszelkich opóźnieniach w momencie zakupu. Może się to zdarzyć na ekranie kasy lub poprzez komunikację masową.

Jak zacząć korzystać z API WooCommerce

WooCommerce REST API działa za pośrednictwem cyfrowego systemu nadawania dostępu i uprawnień opartego na kluczach. Ten proces uwierzytelniania składa się z dwóch odrębnych etapów:

• Woocommerce tworzy dwa klucze: klucz klienta i tajny klucz. Są zrobione z losowych ciągów znaków i są praktycznie niemożliwe do złamania.
• Za każdym razem, gdy chcesz nawiązać połączenie z interfejsem API REST, musisz podać te klucze jako dowód uwierzytelnienia.

Ten proces jest prosty, ale uzyskanie tych kluczy (i korzystanie z samego interfejsu API) wymaga przejścia do pulpitu nawigacyjnego WooCommerce – w szczególności do ekranu WooCommerce> Ustawienia> Zaawansowane . Będziesz chciał poszukać linku REST API u góry, przejść do tego ekranu, a następnie kliknąć przycisk Utwórz klucz API :

Następnie wypełnij pole Opis , pozostawiając pozostałe na razie bez zmian. Powinien to być prosty opis tego, do czego służy dostęp:

Na koniec wybierz przycisk Wygeneruj klucz API i poczekaj, aż WordPress zrobi swoje. Zobaczysz tutaj klucz klienta i klucz tajny , kod QR do dalszego uwierzytelniania oraz link do odwołania dostępu do interfejsu API w przyszłości. Ważne jest, aby teraz skopiować klucze, ponieważ nie można ich później odzyskać.

W tym momencie jesteś gotowy do rozpoczęcia kodowania. Jeśli jest to dla Ciebie coś nowego, dobrym pomysłem jest zatrudnienie programisty do pomocy. Jeśli jednak chcesz sam wskoczyć, możesz użyć „klienta API”, takiego jak Postman lub Insomnia, aby wykonać większość ciężkich zadań:

Aby zobaczyć w prawdziwym świecie, jak korzystać z interfejsu API WooCommerce, możesz sprawdzić blogi programistów na ten temat. Na przykład James Kemp z IconicWP oferuje przydatny wgląd w to, jak aplikacja internetowa PHP i garść kodu mogą łączyć się ze sklepem e-commerce i przetwarzać jego dane.

Wniosek

Jeśli chodzi o wybór platformy przyjaznej zarówno dla użytkowników, jak i programistów, WordPress jest prawdopodobnie numerem jeden. Ponadto WooCommerce jest równie przyjazny dla właścicieli sklepów, którzy chcą prostoty, mocy i elastyczności. Częścią tego, co sprawia, że ​​jest tak elastyczny, jest API REST WooCommerce. Chociaż kiedyś był to oddzielny podmiot, teraz został połączony z głównym WordPress REST API.

W tym artykule przyjrzałem się interfejsowi API WooCommerce i pokazałem, co możesz z nim zrobić. Będziesz chciał dobrze zrozumieć podstawowe pojęcia lub możesz rozważyć zatrudnienie programisty, który zaimplementuje pożądane funkcje. Tak czy inaczej, moc oferowana przez ten interfejs API może mieć bezpośredni, pozytywny wpływ na Twój sklep i dochody.

Zastanawiasz się nad wykorzystaniem API WooCommerce w swoim sklepie, a jeśli tak, to co Cię w nim najbardziej ekscytuje? Daj nam znać w sekcji komentarzy poniżej!

Wyróżnione źródło obrazu: monkographic / shutterstock.com