Kluczowe zmiany w Etsy API v3 i ich wpływ na sprzedawców i programistów:
Jedną z ważnych zmian w Etsy API v3 jest przyjęcie protokołu OAuth 2.0 do uwierzytelniania i autoryzacji. OAuth 2.0 to bezpieczniejszy i powszechnie stosowany standard branżowy. Zapewnia, że tylko autoryzowane aplikacje mają dostęp do danych sprzedawcy i mogą wykonywać czynności w jego imieniu
Etsy API v3 wprowadza zmiany w sposobie, w jaki programiści wysyłają żądania do API. W nowej wersji każde żądanie musi zawierać nagłówek „x-API-key” zawierający klucz API aplikacji Etsy. Ta zmiana zwiększa bezpieczeństwo i pomaga Etsy skuteczniej śledzić żądania interfejsu API. Sprzedawcy i programiści muszą zaktualizować swój kod, aby zawierał ten nagłówek podczas komunikacji z interfejsem API Etsy.
Zmodyfikowano obsługę standardowych parametrów żądania. Parametr zapytania „fields”, używany wcześniej do pobierania zasobów częściowych w wersji 2, nie jest już obsługiwany w wersji 3.
Chociaż parametr zapytania „zawiera” jest nadal dostępny w niektórych punktach końcowych, jego obsługa jest ograniczona. Warto zauważyć, że niektóre punkty końcowe domyślnie zwracają teraz powiązane dane zasobów, co upraszcza wywołanie interfejsu API.
Użytkownicy mogą teraz korzystać ze zaktualizowanego podziału na strony. Parametry zapytania „limit” i „offset” powinny być używane do podziału na strony zamiast parametru „page” używanego w wersji 2. Domyślna liczba rekordów zwracanych na wywołanie interfejsu API to 25, a maksymalna liczba rekordów, które można zwrócić, to 100. Aby ułatwić poruszanie się po większych zbiorach danych, Etsy udostępnia parametry limitu i przesunięcia. Parametr limit umożliwia określenie liczby rekordów do pobrania na stronę. Podczas gdy parametr przesunięcia pomaga przejść do określonej strony wyników.
Dodatkowo odpowiedź zawiera pole licznika, wskazujące całkowitą liczbę rekordów dostępnych do podziału na strony. Należy pamiętać, że ze względów wydajnościowych parametr offset ma maksymalną wartość 50000, co zapewnia wydajną obsługę dużych zbiorów danych.
W zaktualizowanym interfejsie API Etsy w wersji 3 zakresy zasobów służące do filtrowania list zasobów zostały zastąpione filtrami opartymi na ścieżce na filtry oparte na parametrach zapytania.
Przykład: filtrowanie ofert według identyfikatora sklepu i stanu
Załóżmy, że chcesz filtrować oferty według określonego identyfikatora sklepu i stanu. W wersji 2 użyłbyś:
/v2/shops/:identyfikator_sklepu/listings/active
Po przejściu na wersję 3 podejście do adresów URL i parametrów zapytania wyglądałoby następująco:
/v3/application/listings?shop_id=:shop_id&state=active
Tutaj podajesz żądane wartości dla identyfikatora sklepu i stanu jako parametry zapytania.
W poprzedniej wersji Interfejs API Etsy (wersja 2), odpowiedzi API miały znormalizowaną strukturę. Hermetyzowanie różnych pól i obiektów zagnieżdżonych. Jednak w Etsy API v3 odpowiedzi uległy zmianie. W szczególności punkty końcowe, które zwracają listy zasobów, zawierają teraz dwa ważne pola: „liczba” i „wyniki”.
Pole „liczba” wskazuje liczbę wyników w odpowiedzi, zapewniając szybki przegląd całkowitej liczby zwróconych zasobów. Z drugiej strony pole „results” zawiera same obiekty zasobów. Ta poprawiona struktura umożliwia programistom łatwy dostęp do liczby i pobieranie konkretnych wyników z odpowiedzi.
Ponad 40+ zasobów i punktów końcowych zostało zastąpionych lub usuniętych w wersji 3 w różnych kategoriach, takich jak Płatność. ShopListingVariationImage, ShippingProfileUpgrade, User, ShopSection i inne. Pełną listę wycofanych zasobów można znaleźć w dokumentacji.>>https://developers.etsy.com/documentation/migration/retired-resources/
W interfejsie API Etsy w wersji 3 nie wprowadzono żadnych zmian w limitach stawek interfejsu API w porównaniu z wersją 2. Jeśli w wersji 2 używałeś tego samego klucza API aplikacji Etsy, wynegocjowane limity stawek pozostaną takie same również w wersji 3.
Domyślnie aplikacje Etsy uwierzytelnione za pomocą klucza API mogą wysyłać do 10,000 24 publicznych żądań w ciągu 10 godzin, co zapewnia programistom szerokie możliwości interakcji z platformą Etsy i pobierania niezbędnych danych dla ich aplikacji. Limit szybkości (XNUMX zapytań na sekundę) zapewnia uczciwe użytkowanie i utrzymuje stabilność systemu.
Czy wiesz?
Czy masz już sklep eCommerce oparty na Prestashop, Opencart, WooComemrce lub Magento 2? Czy wiesz, że dzięki łącznikowi Knowband Etsy marketplace możesz wyświetlać swoje produkty i zarządzać nimi na rynku Etsy?
Łącznik Knowband Etsy Marketplace jest dostarczany z najnowszymi zmianami API Etsy V3 i zapewnia bezproblemową integrację między Twoją witryną a rynkiem Etsy.
Na przykład możesz zarządzać wszystkimi zamówieniami i ofertami Etsy bezpośrednio z panelu administracyjnego swojego sklepu eCommerce. Ponadto możesz skontaktować się z nami pod adresem support@knowband.com aby uzyskać więcej informacji o Etsy Marketplace Connector.�
Wnioski:
Przejście na Etsy API v3 przynosi ważne zmiany mające na celu zwiększenie bezpieczeństwa, uproszczenie integracji i poprawę ogólnego doświadczenia sprzedawców i programistów. Rozumiejąc i dostosowując się do tych zmian, możesz zapewnić płynność integracja ze zaktualizowaną wersją API Etsy i skutecznie wykorzystać nowe możliwości.
