小红书 API
  1. 订单 API
小红书 API
  • 开发文档
    • 应用开发
    • 新手指南
    • 应用测试
    • 授权流程(自研)
    • 授权流程(软件服务商)
    • 签名算法
    • 系统参数说明
    • 应用消息推送
    • SDK 使用说明
    • 发布服务
  • API 调用场景
    • 商品基础介绍
    • 订单基础介绍
    • 跨境订单介绍
    • 订单接入方案
    • 售后接入说明
  • 数据加解密
    • 数据加密对接方案
    • 加密算法介绍
  • 电子面单
    • 电子面单对接说明
    • 电子面单打印组件协议
  • 规则中心
    • 小红书开放平台开发者协议
    • 数据安全承诺函
    • 服务市场上架审核标准
    • 开发者角色说明
    • 小红书服务市场服务协议(服务商版)
    • 小红书服务市场管理规范
    • 企业管理类目管理规则
    • 商品管理类目管理规则
    • 订单管理类目管理规则
    • 内容工具类目管理规则
    • 小红书服务市场保证金要求
  • 公共 API
    • 批量获取发货时间规则
    • 获取地址信息(新)
    • 获取商家地址库
    • 获取分类列表
    • 由末级分类获取规格(新)
    • 由末级分类获取属性
    • 由属性获取属性值
    • 获取快递公司信息
    • 获取物流方案列表
    • 运费模版列表
    • 运费模版详情
    • 获取品牌信息
    • 获取物流模式列表
    • 获取地址信息
    • 获取老版本商家授权信息
    • cc资质检查
    • 商品标题类目预测
    • 由末级分类获取规格(旧)
  • 订单 API
    • 带货达人侧详情查询
      POST
    • 查询月度结算单下载地址
      POST
    • 订单列表
      POST
    • 订单详情
      POST
    • 订单收件人信息
      POST
    • 修改订单备注
      POST
    • 订单发货
      POST
    • 修改快递单号
      POST
    • 订单物流轨迹
      POST
    • 海关申报信息
      POST
    • 获取取消申请列表(即将下线)
      POST
    • 取消申请审核(即将下线)
      POST
    • 跨境清关支持口岸
      POST
    • 跨境重推支付单
      POST
    • 跨境商品备案信息同步
      POST
    • 跨境商品备案信息查询
      POST
    • 小包批次创建
      POST
    • 开票列表查询
      POST
    • 开票结果回传(正向蓝票开具)
      POST
    • 发票冲红(逆向冲红)
      POST
    • 批量解密
      POST
    • 批量脱敏
      POST
    • 批量获取索引串
      POST
  • 售后 API
    • 售后换货确认收货并发货
    • 获取售后列表
    • 售后详情
    • 售后审核(新)
    • 售后确认收货(新)
  • 商品 API
    • 商品列表基础版
    • 商品列表完整版(新)
    • 更新物流方案
    • 商品上下架
    • 创建ITEM
    • 更新TEM
    • 删除ITEM
    • 创建SKU
    • 更新SKU
    • 删除SKU
    • 查询Item列表
    • 获取ITEM详情
    • 修改价格
    • 修改商品主图、主图视频
    • 修改规格图
  • 库存 API
    • 获取商品库存
    • 同步库存
    • 增减库存
  • 素材中心 API
    • 素材列表
    • 上传素材
    • 修改素材
    • 删除素材
  • 消息文档
    • 商品新建
    • 商品上下架
    • 商品审核驳回
    • 商品删除
  • 物流 API
    • 查询电子面单订购关系
    • 查询电子面单模板列表
    • 批量取号
    • 更新面单
    • 取消面单
    • 查询面单
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  1. 订单 API

订单列表

POST
/ark/open_api/v3/common_controller
错误码错误码描述
-2000400请求参数错误
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://ark.xiaohongshu.com/ark/open_api/v3/common_controller' \
--header 'Content-Type: application/json;charset=utf-8' \
--data-raw '{
    "startTime": 1612518379,
    "endTime": 1612518379,
    "timeType": 1,
    "packageType": 1,
    "packageStatus": 1,
    "pageNo": 1,
    "pageSize": 50
}'
响应示例响应示例
{
  "total": 500,
  "pageNo": 1,
  "pageSize": 50,
  "maxPageNo": 100,
  "packageList": [
    {
      "packageId": "P141***1412",
      "packageType": 1,
      "packageStatus": 1,
      "packageAfterSalesStatus": 1,
      "cancelStatus": 1,
      "createdTime": 1612518379000,
      "paidTime": 1612518379000,
      "updateTime": 1612518379000,
      "deliveryTime": 1612518379000,
      "cancelTime": 1612518379000,
      "finishTime": 1612518379000,
      "promiseLastDeliveryTime": 1612518379000,
      "planInfoId": "null",
      "planInfoName": "null",
      "receiverCountryId": "null",
      "receiverCountryName": "中国",
      "receiverProvinceId": "null",
      "receiverProvinceName": "江苏省",
      "receiverCityId": "null",
      "receiverCityName": "苏州市",
      "receiverDistrictId": "null",
      "receiverDistrictName": "相城区",
      "customerRemark": "null",
      "sellerRemark": "null",
      "sellerRemarkFlag": 1,
      "originalPackageId": "P123***4123",
      "logistics": "red_express"
    }
  ]
}

请求参数

Header 参数
Content-Type
string 
可选
默认值:
application/json;charset=utf-8
Body 参数application/json
startTime
integer 
时间范围起点
必需
endTime
integer 
时间范围终点
必需
timeType
integer 
必需

startTime/endTime对应的时间类型,1 创建时间 限制 end-start<=24h、2 更新时间 限制 end-start<=30min 倒序拉取 最后一页到第一页

packageType
integer 
可选
订单类型,0/null 全部 1 普通 normal 2 定金预售 3 全款预售 4 延迟发货 5 换货补发
packageStatus
integer 
可选
订单状态,0全部 1已下单待付款 2已支付处理中 3清关中 4待发货 5部分发货 6待收货 7已完成 8已关闭 9已取消 10换货申请中
pageNo
integer 
可选
页码,默认1,限制100
pageSize
integer 
可选
查询总数,默认50,限制100
示例

返回响应

🟢200成功
application/json
Body
total
integer 
订单总数
必需
pageNo
integer 
必需
当前页数 请求参数中的值
pageSize
integer 
必需
页大小 请求参数中的值
maxPageNo
integer 
必需
最大页码数 方便 直接从最后一页拉数据
orderList
array [object {27}] 
订单信息
必需
packageId
string 
订单号
可选
packageType
integer 
可选
订单类型,1普通 2定金预售 3全款预售 4延迟发货 5换货补发
packageStatus
integer 
可选
订单状态,1已下单待付款 2已支付处理中 3清关中 4待发货 5部分发货 6待收货 7已完成 8已关闭 9已取消 10换货申请中
packageAfterSalesStatus
integer 
可选
售后状态,1无售后 2售后处理中 3售后完成(含取消) 4售后拒绝 5售后关闭 6平台介入中
cancelStatus
integer 
可选
申请取消状态,0未申请取消 1取消处理中
createdTime
integer 
创建时间 单位ms
可选
paidTime
integer 
支付时间 单位ms
可选
updateTime
integer 
更新时间 单位ms
可选
deliveryTime
integer 
可选
订单发货时间 单位ms
cancelTime
integer 
可选
订单取消时间 单位ms
finishTime
integer 
可选
订单完成时间 单位ms
promiseLastDeliveryTime
integer 
可选
承诺最晚发货时间 单位ms
planInfoId
string 
物流方案id
可选
planInfoName
string 
物流方案名称
可选
receiverCountryId
string 
收件人国家id
可选
receiverCountryName
string 
目前仅 中国
可选
receiverProvinceId
string 
收件人省份id
可选
receiverProvinceName
string 
收件人省份
可选
receiverCityId
string 
收件人城市id
可选
receiverCityName
string 
收件人城市
可选
receiverDistrictId
string 
收件人区县id
可选
receiverDistrictName
string 
收件人区县名称
可选
customerRemark
string 
用户备注
可选
sellerRemark
string 
商家标记备注
可选
sellerRemarkFlag
integer 
可选
商家标记优先级,ark订单列表展示旗子颜色 1灰旗 2红旗 3黄旗 4绿旗 5蓝旗 6紫旗
originalPackageId
string 
可选
原始订单编号,换货订单的原订单
logistics
string 
可选
物流模式red_express三方备货直邮(备货海外仓),red_domestic_trade(三方备货内贸),red_standard(三方备货保税仓),red_auto(三方自主发货),red_box(三方小包),red_bonded(三方保税)

【小红书】API开发者 微信交流群

用微信扫右侧二维码,加入【小红书】API开发者 交流群,互助沟通

扫码加入交流群
上一页
查询月度结算单下载地址
下一页
订单详情
Built with