Co to jest Etsy API?
Etsy zapewnia publiczne API do pobierania i aktualizowania danych z platformy. Każde API pozwala deweloperom tworzyć aplikacje oparte na unikalnych danych i opcjach programu lub strony internetowej. Podobnie, deweloperzy korzystają z Etsy API, aby tworzyć integracje dla sprzedawców i kupujących.
Jak uzyskać klucz API Etsy
Uzyskanie dostępu do API Etsy nie wymaga wiele czasu ani wysiłku. Po pierwsze, musisz uzyskać dostęp do strony społeczności deweloperów Etsy, gdzie możesz zacząć tworzyć własne aplikacje i integracje za pomocą swojego unikalnego klucza API. Postępuj zgodnie z poniższym samouczkiem Etsy API, aby dowiedzieć się, jak uzyskać dostęp do tego interfejsu programistycznego.
- Krok 1 – Utwórz konto
Przejdź na stronę społeczności deweloperów Etsy i zarejestruj nowe konto lub zaloguj się za pomocą istniejącego.
Możesz się zarejestrować za pomocą adresu e-mail lub kontynuować z użyciem konta Google, Facebook lub Apple. - Krok 2 – Dostosuj ustawienia zabezpieczeń
Przed utworzeniem pierwszej aplikacji usługa wymaga ustawienia uwierzytelniania dwuskładnikowego.
Postępuj zgodnie z linkiem i zostaniesz przekierowany na stronę parametrów zabezpieczeń.
Możesz wybrać instalację aplikacji Google Authenticator na urządzeniu mobilnym, aby potwierdzić dostęp za pomocą własnego kodu potwierdzenia z aplikacji. Po wybraniu tej opcji zostaniesz poproszony o pobranie aplikacji i połączenie jej z portalem deweloperów Etsy za pomocą skanowania kodu QR.
Możesz również wybrać weryfikację za pomocą połączenia telefonicznego lub SMS. Wybierając tę opcję, musisz wprowadzić numer telefonu w odpowiednim polu. Po kliknięciu Dalej otrzymasz kod SMS lub automatyczne połączenie telefoniczne, w zależności od wybranej opcji.
- Krok 3 – Utwórz aplikację
Po dostosowaniu wymagań zabezpieczeń możesz zacząć tworzyć swoją pierwszą aplikację. Po pierwsze, musisz wypełnić formularz, aby opisać swoją przyszłą aplikację.
Uzupełnij Captcha i kliknij Przeczytaj warunki i utwórz aplikację.
Zostaniesz poproszony o przeczytanie warunków i regulaminu Etsy API w oknie podręcznym. Zapoznaj się z dokumentem, aby być świadomym wymagań i ograniczeń podczas korzystania z interfejsu programistycznego. Zaznacz pole wyboru i kliknij Utwórz aplikację.
- Krok 4 – Pobierz swoje poświadczenia API
Po zaakceptowaniu warunków i regulaminu uzyskasz dostęp do swojego klucza API i sekretu.
Pamiętaj, aby zachować swoje poświadczenia API w tajemnicy i nie pokazywać ani nie wysyłać ich osobom trzecim.
Jak korzystać z Etsy API
Gdy po raz pierwszy tworzysz aplikację, ma ona domyślny dostęp tymczasowy do usług Etsy podczas procesu rozwoju. Dostęp tymczasowy obejmuje następujące funkcje:
- Dostęp do odczytu do dowolnych otwartych, nieuwierzytelnionych zasobów, takich jak Sklepy i Skarbnice.
- Dostęp uwierzytelniony (odczyt i zapis) do danych należących do właściciela aplikacji. Ten dostęp pozwala na odczyt danych osobowych, takich jak Paragony i Rozliczenia, oraz tworzenie, edytowanie lub usuwanie ofert w sklepie. Jeśli jest to konieczne, możesz również złożyć wniosek o dostęp dla małej grupy użytkowników testowych oprócz właściciela aplikacji.
Etsy oferuje również pełny dostęp, który umożliwia uwierzytelniony dostęp do danych nieograniczonej liczby członków platformy Etsy. Jeśli integracja, którą rozwijasz, nie wymaga takich uprawnień, możesz po prostu korzystać z aplikacji w trybie tymczasowym.
Jeśli nadal chcesz uzyskać pełny dostęp dla swojej aplikacji, powinieneś najpierw użyć dostępu tymczasowego do rozwoju aplikacji i sprawdzenia, czy spełniasz wymagania platformy dotyczące pełnego dostępu.
Przykłady użycia Etsy API
Etsy API recenzji
Platforma Etsy posiada system opinii, który pozwala kupującym i sprzedającym na pozostawienie opinii o konkretnych transakcjach na platformie. Zapewnia kilka metod do znalezienia konkretnych rodzajów opinii dostępnych na platformie. Są to na przykład findAllUserFeedbackAsAuthor, findAllUserFeedbackAsBuyer, findAllUserFeedbackAsSeller
i wiele innych.
Oto przykład metody findAllFeedbackFromBuyers, która pozwala pobrać i wykorzystać opinie od klientów.
Nazwa metody | findAllFeedbackFromBuyers |
Streszczenie | Zwraca zestaw obiektów Feedback skojarzonych z użytkownikiem. Jest to zasadniczo unia między metodami findAllUserFeedbackAsBuyer i findAllUserFeedbackAsSubject. |
Metoda HTTP | GET |
URI | /users/:user_id/feedback/from-buyers |
Jeśli szukasz sposobu na wyświetlenie recenzji klientów ze swojego sklepu Etsy, spróbuj gotowego widgetu recenzji!
Etsy API płatności
API Płatności i Transakcji reprezentują część narzędzi dla sprzedawców Etsy. Wszystkie sprzedaże i zakupy dokonane za pośrednictwem platformy Etsy są podzielone na trzy główne źródła: Zamówienia, Paragony i Transakcje. API Płatności reprezentuje płatność dokonaną za pomocą Etsy Payments.
Etsy API ofert
Oferty Etsy to przedmioty dostępne do sprzedaży. Każda oferta jest powiązana z użytkownikiem i sklepem (użytkownikiem, który jest właścicielem tego sklepu). Oferty posiadają cenę i ilość dołączoną do nich, a gdy są wyprzedane, właściciel sklepu musi odnowić przedmioty, zanim będą mogły być ponownie sprzedane. API ofert Etsy posiada metody do wyszukiwania i pobierania ofert różnych kategorii, a także do tworzenia i usuwania ofert. Kategorie te obejmują: Aktywne, Interesujące, Popularne, Paragony i inne oferty. API ofert Etsy może pobrać przedmioty sprzedawcy za pomocą metody findAllShopListingsActive, która znajduje wszystkie aktywne oferty należące do sklepu.
Dokumentacja Etsy API
Strona społeczności deweloperów Etsy oferuje rozwiniętą sekcję dokumentacji dla swoich członków. Istnieje przewodnik podstawowy dla deweloperów, którzy są nowicjuszami w interfejsie programistycznym Etsy, aby pomóc im zacząć pracę z nim. Unikalną sekcją portalu API deweloperów Etsy jest sekcja dyskusji. Każdy może wziąć udział w dyskusji, aby poprosić o pomoc i podzielić się doświadczeniami.
FAQ
Czy Etsy ma API?
Tak, Etsy zapewnia szeroki zakres rozwiązań dla deweloperów, podzielonych na dwie główne kategorie – narzędzia dla sprzedawców i kupujących. Dostęp do API Etsy jest udostępniony bezpłatnie szerokiej publiczności.
Jak znaleźć ID oferty Etsy?
Każda oferta Etsy ma unikalny numer identyfikacyjny. Można go znaleźć w adresie URL oferty. Podczas przeglądania oferty Etsy jej ID jest dostępne na końcu adresu internetowego. Adresy URL ofert są w formacie: www.etsy.com/listing/ID_oferty/.
Co to jest mój klucz API Etsy?
Używanie API Etsy wymaga unikalnego klucza aplikacji dostarczonego podczas rejestracji aplikacji. Ten klucz API identyfikuje aplikację na platformie Etsy i jest używany do śledzenia limitów wywołań.
Gdzie znaleźć moje API Etsy?
Możesz znaleźć swoje unikalne API dla każdej aplikacji Etsy, którą utworzyłeś w swoim koncie dewelopera Etsy. Przejdź do zakładki Aplikacje, które utworzyłeś, i kliknij na wymaganą aplikację, aby zobaczyć jej poświadczenia. Jeśli nie masz konta dewelopera lub utworzonej aplikacji, sprawdź drugą sekcję naszego artykułu powyżej.