1. 开发指南
雅仓开放平台
  • 下线通知
  • [公告]雅仓旧版接口服务停止更新及对接新接口服务的通知
  • 接口更新
  • 开发指南
    • 开发前必读
    • 获取token
      POST
    • refresh_token
      POST
  • 商品
    • 资料
      • 资料列表
      • 详情
      • 添加
      • 修改
      • 删除
    • 库存
      • 库存列表
    • 入库
      • 入库列表
      • 入库详情
      • 申请入库
      • 入库单删除
      • 入库商品详情
  • 订单
    • 订单列表
      GET
    • 订单详情
      GET
    • 订单创建
      POST
    • 取消发货
      POST
    • 订单查询
      POST
    • 确认包裹上线
      POST
  • 仓库
    • 仓库列表
      GET
  • 物流渠道
    • 仓库与物流渠道
      GET
  • 消息订阅
    • 概述
    • 订阅设置
      POST
  • 销售平台
    • 销售平台
      GET
  1. 开发指南

开发前必读

系统角色#

客户系统:调用雅仓开放API的上游客户系统
雅仓系统:雅仓开放平台
仓库管理系统:wms

开发说明#

开发文档通过目录导航可以快速预览,目录树按功能块聚合归类,如商品管理、入库管理、出库管理等。
所有的接口需使用HTTPS / HTTP 协议、JSON数据格式、UTF8编码。
返回结果说明:仅需判断响应中的status属性来识别操作成功还是失败,当操作失败时,可以通过具体的message属性来判断具体失败的原因,特别的,当操作返回成功时,status属性固定返回1。而message属性仅做参考,可能会发生变化,不应该作为调用方业务处理逻辑的判断依据。
授权问题,状态码400,具体内容参考message
{ "status": 400, "message": "token 已过期" }

接口调用地址#

环境host
测试http://test-openapi.seaya.cn/api
线上https://openapi.seaya.cn/api

接口调用流程#

faa1a5a4-41b4-4aa5-9fc5-4da636111df2.png

1. 获取token#

跳转用户授权页面,用户登录后跳转 redirect_url(回调地址) ,有个参数code返回给开发者,
开发者通过code去调用获取token,code有效期 5 分钟
测试授权地址:https://m-develop.seaya.cn/otherLogin?redirect_url=
测试账号:13423568306
密码:123456
线上授权地址:https://m.seaya.cn/otherLogin?redirect_url=

2. 刷新token#

开发者可以缓存 refresh_token,token过期后调用refresh_token
来重新获取token 有效期 1 天,refresh_token 有效期 30 天 ;

3. 用token调用具体的业务接口#

修改于 2025-07-22 08:08:46
上一页
接口更新
下一页
获取token
Built with