open api

Добро пожаловать!

Etsy — это глобальный рынок уникальных и креативных товаров. Мы руководствуемся нашей миссией: сохранить коммерцию человечной. Открытый API Etsy поддерживает сотни интеграций, используемых тысячами продавцов. Это пространство — новый способ для нас напрямую сотрудничать с такими разработчиками, как вы.

Что мы делаем

Мы разрабатываем новую версию нашего Open API. За последний год мы создали новую основу для обновленных конечных точек и разработки новой документации. Цель этой работы — удовлетворить потребности сообщества разработчиков Etsy и облегчить нашей команде быстрое обновление Open API, когда эти потребности меняются.

Open API v3 ориентирован на три основных варианта использования — управление листингами, управление заказами после покупки и управление магазином. Мы создали около 70 конечных точек, соответствующих этим вариантам использования, и готовы выслушать ваши отзывы. Вы можете изучить эти новые конечные точки, включая спецификации запросов и ответов, на нашем новом справочном сайте API.

Почему мы строим под открытым небом

Мы потратили много времени на изучение данных и диаграмм, но понимаем, что наши пользователи лучше всех знают свои потребности. У нас также есть подозрение, что многие из вас разделяют одни и те же потребности. Делясь нашими планами, документацией и прогрессом на Github, мы все можем работать вместе над созданием открытого API, который вам нужен.

С чего начать

Мы создали новый сайт документации для Open API v3, который можно найти по адресу Developers.etsy.com/documentation. Мы продолжим добавлять новый контент, но предоставили руководство по миграции и задокументировали некоторые основы API. Если вам нужна конкретная документация или у вас есть отзывы, не стесняйтесь создавать проблему.

Любой разработчик с активным приложением Etsy может отправлять запросы, используя наши конечные точки Open API v3. Посетите etsy.com/developers/your-apps, чтобы найти свой ключ API.

Полезные ссылки для начала

• Переход на версию 3
• аутентификация OAuth2
• Оформление запросов
• Справочная документация API v3
• Спецификация OpenAPI JSON

Какую обратную связь мы ищем?

Мы хотели бы услышать о запросах функций, предлагаемых изменениях схемы конечных точек, отчетах об ошибках и любых проблемах с документацией. Откройте проблему, чтобы предложить изменения, или оставьте общий отзыв.

Как оставить отзыв

Мы создали несколько шаблонов задач, чтобы вам было проще. Как правило, ошибки и запросы функций для API v3 или документации должны быть проблемами Github. Все остальное следует отправлять в виде запроса в службу поддержки на адрес [email protected].

Мы также стремились упростить предоставление отзывов непосредственно из нашей справочной документации по API. Каждое определение конечной точки включает ссылку для регистрации ошибки или запроса функции с заполнением некоторых сведений.

Обратите внимание, что, отправляя ваш отзыв, мы имеем право его использовать.

С юридической точки зрения это означает, что это считается для вас неконфиденциальным и не являющимся собственностью, и вы предоставляете Etsy неисключительную, всемирную, безвозмездную, безотзывную, сублицензируемую, бессрочную лицензию на использование и публикацию этих идей и материалов для для любых целей, без какой-либо компенсации вам.

Правила сообщества

Мы также включили Кодекс поведения Etsy с открытым исходным кодом. Мы ожидаем, что все члены сообщества будут соблюдать этот кодекс при участии в обсуждениях или предоставлении отзывов.

© 2011-2021 Etsy, Inc. Все права защищены. Использование этого кода регулируется Условиями использования API Etsy для разработчиков, доступными по адресу https://www.etsy.com/legal/api.