Что такое Etsy API?
Etsy предоставляет публичный API для извлечения и обновления данных с платформы. Каждый API позволяет разработчикам создавать приложения на основе уникальных данных и опций программы или веб-сайта. Аналогично разработчики используют API Etsy для создания интеграций для продавцов и покупателей.
Как получить ключ API Etsy?
Доступ к веб-API Etsy не требует много времени или усилий. Сначала вам нужно получить доступ к веб-сайту сообщества разработчиков Etsy, где вы можете использовать свой уникальный ключ API для создания собственных приложений и интеграций. Следуйте этому руководству по API Etsy ниже, чтобы узнать, как вызвать этот интерфейс программирования.
- Шаг 1. Создайте учетную запись
Перейдите на сайт сообщества разработчиков Etsy и зарегистрируйте новую учетную запись или войдите в систему с помощью существующей.
Вы можете зарегистрироваться, используя свой адрес электронной почты, или продолжить с помощью своей учетной записи Google, Facebook или Apple. - Шаг 2. Настройте параметры безопасности
Перед созданием вашего первого приложения сервис требует двухфакторной аутентификации.
Перейдите по ссылке, и вы будете перенаправлены на страницу параметров безопасности.
Вы можете выбрать один из нескольких вариантов: Установка приложения Google Authenticator на ваше мобильное устройство для подтверждения доступа с помощью вашего собственного кода проверки через приложение. После выбора этой опции вам будет предложено загрузить приложение и подключиться к порталу разработчиков Etsy, отсканировав QR-код.
Вы также можете выбрать проверку с помощью телефонного звонка или SMS. Если вы выберете эту опцию, вам нужно будет ввести свой номер телефона в соответствующее поле. После нажатия кнопки «Далее» вы получите SMS-код или автоматический телефонный звонок в зависимости от выбранного вами варианта.
- Шаг 3. Создание приложения
После настройки требований безопасности вы можете приступить к созданию своего первого приложения. Сначала вам необходимо заполнить форму, чтобы описать свое будущее приложение.
Заполните капчу и нажмите «Ознакомьтесь с условиями и положениями и создайте приложение».
Во всплывающем окне вам будет предложено прочитать Условия использования API Etsy. Ознакомьтесь с документом, чтобы понять требования и ограничения при использовании API. Щелкните поле и нажмите «Создать приложение».
- Шаг 4. Получите учетные данные API
После согласия с условиями обслуживания вы получите доступ к своему ключу API и секрету.
Не забудьте сохранить свои учетные данные API в секрете и не делиться ими и не показывать их никому.
Как использовать API Etsy?
Когда вы создаете приложение, по умолчанию оно имеет предварительный доступ к сервисам Etsy во время процесса разработки. Предварительный доступ предоставляет следующие возможности:
- Доступ на чтение ко всем открытым, неаутентифицированным ресурсам, таким как магазины и хранилища.
- Аутентифицированный (чтение и запись) доступ к данным владельца приложения. Этот доступ дает возможность читать персональные данные, такие как квитанции и выписки, а также создавать, редактировать или удалять листинги магазина. При необходимости вы можете запросить доступ для небольшой группы тестовых пользователей в дополнение к владельцу приложения.
Etsy также предлагает полный доступ, который обеспечивает аутентифицированный доступ к неограниченным данным участников Etsy. Если интеграция, которую вы разрабатываете, не требует этих привилегий, вы можете просто использовать приложение в предварительном режиме.
Если вы все равно хотите полный доступ для своего приложения, вам следует сначала использовать предварительный доступ, чтобы разработать приложение и заставить его работать должным образом, а затем убедиться, что вы соответствуете требованиям платформы для полного доступа.
Примеры API Etsy
API отзывов Etsy
Платформа Etsy имеет систему отзывов, которая позволяет покупателям и продавцам давать друг другу отзывы о конкретных транзакциях. Она предлагает несколько методов для поиска определенных типов отзывов, доступных на платформе. К ним относятся, например, findAllUserFeedbackAsAuthor, findAllUserFeedbackAsBuyer, findAllUserFeedbackAsSeller и другие.
Вот пример метода findAllFeedbackFromBuyers, который можно использовать для получения и использования отзывов от клиентов:
| Метод | findAllFeedbackFromBuyers |
| Сводка | Возвращает массив объектов Feedback, связанных с пользователем. По сути, это объединение методов findAllUserFeedbackAsBuyer и findAllUserFeedbackAsSubject. |
| Метод HTTP | GET |
| URI | /users/:user_id/feedback/from-buyers |
Если вы ищете способы отображения отзывов клиентов из вашего магазина Etsy, попробуйте готовый виджет отзывов!
API платежей Etsy
API платежей и API транзакций являются частью набора инструментов продавца Etsy. Все продажи и покупки, совершаемые через Etsy, делятся на три основных источника: заказы, квитанции и транзакции. API платежей представляет платеж, сделанный через Etsy Payments.
API листингов Etsy
Листинги Etsy — это товары для продажи. Каждый листинг связан с пользователем и магазином. Листинги имеют цену и количество. После распродажи товара, его нужно пополнить, чтобы снова начать продажу. Существуют методы для поиска листингов по категориям: активные, избранные, трендовые и т.д. API листингов Etsy позволяет получить активные товары с помощью метода findAllShopListingsActive.
Документация API Etsy
Сайт сообщества разработчиков Etsy предлагает обширную документацию. Для новичков доступно руководство по основам API. Также существует раздел обсуждений, где можно задать вопросы и поделиться опытом.
FAQ
Есть ли у Etsy API?
Да, Etsy предлагает широкий спектр решений для разработчиков, разделенных на две основные категории — инструменты для продавцов и для покупателей. API предоставляется бесплатно.
Как узнать свой идентификатор листинга Etsy?
Каждый листинг имеет уникальный ID, который отображается в конце URL: www.etsy.com/listing/Listing-ID/.
Какой у меня ключ API Etsy?
После регистрации приложения вы получите уникальный ключ API, используемый для авторизации запросов.
Где найти мой API Etsy?
Перейдите в аккаунт разработчика, откройте вкладку с вашими приложениями, и выберите нужное — ключ будет указан там.
API отзывов Etsy
Платформа Etsy имеет систему отзывов, которая позволяет покупателям и продавцам давать друг другу отзывы о конкретных транзакциях. Она предлагает несколько методов для поиска определенных типов отзывов, доступных на платформе. К ним относятся, например, findAllUserFeedbackAsAuthor, findAllUserFeedbackAsBuyer, findAllUserFeedbackAsSeller и другие.
Вот пример метода findAllFeedbackFromBuyers, который можно использовать для получения и использования отзывов от клиентов:
| Метод | findAllFeedbackFromBuyers |
| Сводка | Возвращает массив объектов Feedback, связанных с пользователем. По сути, это объединение методов findAllUserFeedbackAsBuyer и findAllUserFeedbackAsSubject. |
| Метод HTTP | GET |
| URI | /users/:user_id/feedback/from-buyers |
Если вы ищете способы отображения отзывов клиентов из вашего магазина Etsy, попробуйте готовый виджет отзывов!
API платежей Etsy
API платежей и API транзакций являются частью набора инструментов продавца Etsy. Все продажи и покупки, совершаемые через Etsy, делятся на три основных источника: заказы, квитанции и транзакции. API платежей представляет платеж, сделанный через Etsy Payments.
API отзывов Etsy
Платформа Etsy имеет систему, позволяющую участникам оставлять отзывы по конкретным транзакциям. Существуют методы поиска различных типов отзывов, таких как findAllUserFeedbackAsAuthor, findAllUserFeedbackAsBuyer, findAllUserFeedbackAsSeller и др.
Вот пример метода findAllFeedbackFromBuyers, который позволяет получить отзывы от клиентов:
| Метод | findAllFeedbackFromBuyers |
| Сводка | Возвращает массив объектов Feedback, связанных с пользователем. Объединяет методы findAllUserFeedbackAsBuyer и findAllUserFeedbackAsSubject. |
| Метод HTTP | GET |
| URI | /users/:user_id/feedback/from-buyers |
Хотите отображать отзывы клиентов с Etsy на своём сайте? Попробуйте готовый виджет отзывов от Elfsight!
API платежей Etsy
API платежей и API транзакций входят в набор инструментов продавца. Все продажи через Etsy разбиваются на заказы, квитанции и транзакции. API платежей описывает операции, выполненные с помощью Etsy Payments.
API листингов Etsy
Листинги — это товары, выставленные на продажу. Каждый листинг привязан к магазину и пользователю, имеет цену и количество. Когда товар заканчивается, продавцу нужно обновить листинг. API листингов Etsy включает методы поиска, создания и удаления товаров. Например, метод findAllShopListingsActive позволяет получить все активные товары магазина.
Документация API Etsy
На сайте разработчиков Etsy размещена обширная документация. Новичкам рекомендуется начать с руководства по основам. Также есть форум для обсуждений и помощи.
FAQ
Есть ли у Etsy API?
Да, Etsy предлагает широкий спектр API-инструментов для продавцов и покупателей. Доступ бесплатный после регистрации приложения.
Как узнать свой идентификатор листинга Etsy?
ID листинга можно найти в URL страницы товара: www.etsy.com/listing/Listing-ID/.
Какой у меня ключ API Etsy?
Вы получаете уникальный ключ при регистрации приложения на Etsy. Он используется для идентификации запросов.
Где найти мой API Etsy?
Войдите в аккаунт разработчика Etsy, перейдите в раздел «Мои приложения» и откройте нужное — ключ будет в его описании.
