Using the SHOPLINE Developer M…

# SHOPLINE开放平台创建应用并拉取订单实操指南

一、创建应用获取API凭证

1. 登录 [SHOPLINE开放平台](https://developer.shopline.com/)（需先注册开发者账号）

2. 进入控制台，点击「创建应用」，选择应用类型：

• 自定义应用：仅授权给自己店铺，适合拉取自家订单数据（推荐）
• 公共应用：需上架审核，面向多商家

3. 填写应用名称、描述等基础信息，完成创建

4. 在应用详情页获取凭证：

• App Key（Client ID）
• App Secret（Client Secret）

5. 申请并开通所需权限Scope：需申请订单读取权限（如 read_orders 类订单相关权限），等待授权通过

二、获取Access Token

• 自定义应用/店铺级授权：一般通过授权码模式完成OAuth授权，引导商家授权后回调获取 access_token
• 授权后妥善保存token（注意有效期，过期需刷新）

三、调用orders接口拉取近30天已付款订单

接口要点：

• 请求方式：GET，调用订单列表接口（如 /admin/openapi/v2023xxxx/orders.json，具体版本以官方文档为准）
• 关键参数：
• financial_status=paid（已付款）
• created_at_min / created_at_max：设置为近30天起止时间
• limit：单页条数（通常上限50或更多，以文档为准）
• page_info 或分页游标：用于翻页遍历
• 注意API限流规则（令牌桶机制），遇429错误需退避重试

示例请求逻辑：

```

GET /orders.json?financial_status=paid

&created_at_min=30天前时间&created_at_max=当前时间

&limit=50

Headers: Authorization: Bearer {access_token}

```

四、导出订单数据

1. 循环分页拉取，直到无下一页游标，合并所有订单

2. 解析JSON，提取核心字段：订单号、下单时间、付款时间、客户信息、金额、商品明细等

3. 用Python pandas处理：

• pd.json_normalize() 展平嵌套结构
• df.to_csv('orders_30d.csv', index=False, encoding='utf-8-sig') 导出

4. 建议：脚本中加入失败重试与日志，定时任务可实现每日自动同步

注意事项： 各接口版本号、字段名以官方文档最新说明为准；测试建议先在测试店铺进行，避免影响生产数据。