Shopify Python API:官方 Shopify Admin SDK

发布时间:2026/6/8 22:11:43

Shopify Python API:官方 Shopify Admin SDK 文章目录Shopify Python API官方 Shopify Admin SDK1、认证流程2、API 调用方式3、应用计费4、需要注意的事5、安装Shopify Python API官方 Shopify Admin SDKShopify Python API 在 GitHub 上已经拿到 1,427 Star。这是 Shopify 官方维护的 Python SDK用来对接 Shopify Admin API。做 Shopify 应用开发的开发者无论是做公开应用还是私有应用都需要这个库来处理认证和 API 调用。1、认证流程Shopify 应用分三种公开应用、自定义应用、私有应用。这个 SDK 对三种场景都做了封装。公开应用和自定义应用走 OAuth 2.0 流程。先用 API Key 和 Secret 初始化 Session再生成授权链接让用户跳转商户确认后回调里用临时 code 换取永久 access_token。代码大致这样importshopify shopify.Session.setup(api_keyAPI_KEY,secretAPI_SECRET)sessionshopify.Session(shop_url,api_version)access_tokensession.request_token(request_params)私有应用更简单不需要 OAuth直接用 Private App 密码当 tokensessionshopify.Session(shop_url,api_version,private_app_password)shopify.ShopifyResource.activate_session(session)也支持临时 Session上下文管理器自动清理withshopify.Session.temp(shop_url,api_version,token):shopify.GraphQL().execute({ shop { name id } })2、API 调用方式拿到 token 并 activate_session 之后就可以调用 REST 或 GraphQL 接口。REST 用法是 ActiveResource 风格基于 pyactiveresource 实现shopshopify.Shop.current()productshopify.Product.find(179761209)product.price19.99product.save()product.destroy()支持带参数的查询和分页new_ordersshopify.Order.find(statusopen,limit50)page1shopify.Product.find()ifpage1.has_next_page():page2page1.next_page()前缀资源如订单下的 fulfillment需要传入父资源 IDshopify.Fulfillment.find(255858046,order_id450789469)GraphQL 调用更直接resultshopify.GraphQL().execute({ shop { name id } })也支持带变量和 operation_name 的复杂查询。3、应用计费公开应用需要接入 Shopify 的计费系统。SDK 封装了 ApplicationCharge 的创建和激活application_chargeshopify.ApplicationCharge.create({name:My public app,price:123,test:True,return_url:https://domain.com/approve})创建后跳转到 confirmation_url 让用户确认确认后检查 charge 状态即可。4、需要注意的事Shopify 在逐步废弃 REST Admin API公开应用要在 2025 年 2 月前迁移到 GraphQL自定义应用是 2025 年 4 月。新开发建议直接用 GraphQL。这个库目前不支持异步请求和持久连接高并发场景需要自行处理。5、安装pipinstall--upgradeShopifyAPIPython 3.7 到 3.12 都支持。包内还附带了一个 shopify_api.py 命令行工具可以配置默认凭证后直接进入交互式控制台调试 API。ade ShopifyAPIPython 3.7 到 3.12 都支持。 包内还附带了一个 shopify_api.py 命令行工具可以配置默认凭证后直接进入交互式控制台调试 API。

相关新闻