Etsy

简介

Etsy Open API v3 暴露商品、店铺和交易——用于卖家工具和市场应用。认证是 OAuth 2.0（未认证请求返回 403，已实测）。

快速开始

OAuth 令牌流程：在 etsy.com/developers 注册应用 → 获取 Client ID + Secret → OAuth 2.0（Authorization Code + PKCE）。然后（替换 YOUR_TOKEN）：

curl "https://openapi.etsy.com/v3/application/shops" \
  -H "Authorization: Bearer YOUR_TOKEN"

{
  "count": 1,
  "results": [
    { "shop_id": 12345, "shop_name": "MyShop", "title": "Handmade goods", "url": "https://www.etsy.com/shop/MyShop" }
  ]
}

认证方式

• 在 etsy.com/developers 注册 → 创建应用 → Client ID + Secret。
• OAuth 2.0 + PKCE（公开客户端）——用户授权店铺访问。
• 把访问令牌作为 Authorization: Bearer YOUR_TOKEN 发送（缺失 → 403，已实测）。

速率限制与注意事项

• 限流按端点和应用等级（见文档）——Open API 免费使用。
• v3 是当前 API（v2 已退役）。
• 关键资源：商品、店铺、收据、物流和支付。
• API 需要每个店铺的用户同意作用域。

常见问题

Etsy API 免费吗？ Open API 免费带限流。

如何获取令牌？ 注册应用 → OAuth 2.0 流程 → 用户同意。

为什么 403？ 端点需要 Bearer 令牌（已实测）。