文档说明
看店通提供完整的RESTful API接口，支持商品、订单、用户、支付等核心业务的二次开发和系统集成。开发者可通过API实现与ERP、CRM、第三方系统等的数据对接，实现业务流程自动化。本文档为接口概览，完整API文档即将上线。
一、接口概览
看店通API采用RESTful设计风格，遵循HTTP语义，使用GET、POST、PUT、DELETE等标准方法。接口按业务模块划分，便于开发者快速定位所需功能。
- 商品接口：商品列表、详情、分类、SKU、库存、批量操作、上下架
- 订单接口：订单创建、查询、状态变更、退款、物流、批量导出
- 用户接口：用户信息、会员等级、积分、优惠券、地址、标签
- 支付接口：预支付、支付回调、退款、对账
- 营销接口：优惠券、活动、拼团、秒杀、满减
- 分销接口：分销员、佣金、提现记录
二、认证方式
API采用OAuth2.0风格的Token认证机制。开发者需先在后台获取API密钥，再通过密钥换取access_token。Token有效期为2小时，过期后需重新获取。请求时在Header中携带：
Authorization: Bearer {access_token}
获取Token的接口为POST /oauth/token，需传入client_id、client_secret、grant_type等参数。建议在客户端实现Token自动刷新逻辑，避免频繁请求导致限流。
三、请求规范
- Base URL：https://api.kandiantong.com/v1
- 请求格式：Content-Type: application/json
- 响应格式：Content-Type: application/json
- 字符编码：UTF-8
- 时间格式：ISO 8601
所有接口统一返回格式，包含code、message、data字段。code为0表示成功，非0表示错误码。分页接口支持page、page_size参数，默认每页20条。
四、响应示例
成功响应示例：{"code":0,"message":"success","data":{"id":1,"name":"商品A"}}。错误响应示例：{"code":40001,"message":"参数错误","data":null}。分页响应中data为对象，包含list数组和total总数。
五、错误码说明
常见错误码：400参数错误、401未认证、403无权限、404资源不存在、429请求过于频繁、500服务器错误。建议在业务逻辑中做好错误处理，对429等可重试错误实现指数退避重试。具体错误码定义请参考完整API文档。
六、限流与频率
为保证服务稳定性，API对单商户有请求频率限制。默认限制为每分钟100次，超出后返回429。建议合理设计请求逻辑，避免短时间内大量请求。批量操作时优先使用批量接口而非循环单条。
七、SDK与工具
看店通提供多语言SDK（PHP、Java、Python等），封装了认证、请求、错误处理等逻辑，可大幅提升开发效率。同时提供Postman集合、接口调试工具，方便开发者快速测试。SDK与工具可通过开发者中心下载。
