小红书 API
  1. 物流 API
小红书 API
  • 开发文档
    • 应用开发
    • 新手指南
    • 应用测试
    • 授权流程(自研)
    • 授权流程(软件服务商)
    • 签名算法
    • 系统参数说明
    • 应用消息推送
    • SDK 使用说明
    • 发布服务
  • API 调用场景
    • 商品基础介绍
    • 订单基础介绍
    • 跨境订单介绍
    • 订单接入方案
    • 售后接入说明
  • 数据加解密
    • 数据加密对接方案
    • 加密算法介绍
  • 电子面单
    • 电子面单对接说明
    • 电子面单打印组件协议
  • 规则中心
    • 小红书开放平台开发者协议
    • 数据安全承诺函
    • 服务市场上架审核标准
    • 开发者角色说明
    • 小红书服务市场服务协议(服务商版)
    • 小红书服务市场管理规范
    • 企业管理类目管理规则
    • 商品管理类目管理规则
    • 订单管理类目管理规则
    • 内容工具类目管理规则
    • 小红书服务市场保证金要求
  • 公共 API
    • 批量获取发货时间规则
    • 获取地址信息(新)
    • 获取商家地址库
    • 获取分类列表
    • 由末级分类获取规格(新)
    • 由末级分类获取属性
    • 由属性获取属性值
    • 获取快递公司信息
    • 获取物流方案列表
    • 运费模版列表
    • 运费模版详情
    • 获取品牌信息
    • 获取物流模式列表
    • 获取地址信息
    • 获取老版本商家授权信息
    • cc资质检查
    • 商品标题类目预测
    • 由末级分类获取规格(旧)
  • 订单 API
    • 带货达人侧详情查询
    • 查询月度结算单下载地址
    • 订单列表
    • 订单详情
    • 订单收件人信息
    • 修改订单备注
    • 订单发货
    • 修改快递单号
    • 订单物流轨迹
    • 海关申报信息
    • 获取取消申请列表(即将下线)
    • 取消申请审核(即将下线)
    • 跨境清关支持口岸
    • 跨境重推支付单
    • 跨境商品备案信息同步
    • 跨境商品备案信息查询
    • 小包批次创建
    • 开票列表查询
    • 开票结果回传(正向蓝票开具)
    • 发票冲红(逆向冲红)
    • 批量解密
    • 批量脱敏
    • 批量获取索引串
  • 售后 API
    • 售后换货确认收货并发货
    • 获取售后列表
    • 售后详情
    • 售后审核(新)
    • 售后确认收货(新)
  • 商品 API
    • 商品列表基础版
    • 商品列表完整版(新)
    • 更新物流方案
    • 商品上下架
    • 创建ITEM
    • 更新TEM
    • 删除ITEM
    • 创建SKU
    • 更新SKU
    • 删除SKU
    • 查询Item列表
    • 获取ITEM详情
    • 修改价格
    • 修改商品主图、主图视频
    • 修改规格图
  • 库存 API
    • 获取商品库存
    • 同步库存
    • 增减库存
  • 素材中心 API
    • 素材列表
    • 上传素材
    • 修改素材
    • 删除素材
  • 消息文档
    • 商品新建
    • 商品上下架
    • 商品审核驳回
    • 商品删除
  • 物流 API
    • 查询电子面单订购关系
      POST
    • 查询电子面单模板列表
      POST
    • 批量取号
      POST
    • 更新面单
      POST
    • 取消面单
      POST
    • 查询面单
      POST
  • 素材中心 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
请求示例请求示例
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 '{
    "cpCode": "",
    "waybillCode": "",
    "objectId": "1",
    "logisticsServices": "",
    "packageInfo": {
        "items": [
            {
                "count": "",
                "name": "",
                "specification": ""
            }
        ],
        "volume": "",
        "weight": "",
        "length": "",
        "width": "",
        "height": ""
    },
    "recipient": {
        "address": {
            "city": "",
            "detail": "",
            "district": "",
            "province": "",
            "town": ""
        },
        "mobile": "",
        "name": "",
        "phone": "",
        "openAddressId": ""
    },
    "sender": {
        "mobile": "",
        "name": "",
        "phone": ""
    },
    "templateId": ""
}'
响应示例响应示例
{
  "error_code": "",
  "error_msg": "",
  "success": "true",
  "data": {
    "waybill": {
      "objectId": "1",
      "waybillCode": "78689455849606",
      "printData": "{\\\"encryptedData\\\":\\\"打印数据密文\\\",\\\"signature\\\":\\\"MD:lH0r2gNxcIuY7dY3VvV4ag==\\\",\\\"templateURL\\\":\\\"http://cloudprint.cainiao.com/template/standard/644703\\\",\\\"ver\\\":\\\"waybill_print_xiaohongshu_secret\\\"}",
      "parentWaybillCode": "",
      "extraInfo": "",
      "cpCode": "",
      "customerPrintData": "{\\\"data\\\":{\\\"item\\\":[\\\"商品名称\\\"],\\\"order\\\":[\\\"P000000001\\\"]},\\\"templateURL\\\":\\\"https://cloudprint.cainiao.com/template/standard/629505/24\\\"}"
    },
    "subErrorCode": ""
  }
}

请求参数

Header 参数
Content-Type
string 
可选
默认值:
application/json;charset=utf-8
Body 参数application/json
cpCode
string 
快递公司编码
必需
waybillCode
string 
快递单号
必需
objectId
string 
请求id
必需
logisticsServices
string 
可选
增值服务,见对接说明附录物流增值服务
packageInfo
object 
可选
items
array [object {3}] 
商品信息
可选
volume
string 
体积, 单位 ml
可选
weight
string 
重量,单位 g
可选
length
string 
包裹长,单位厘米
可选
width
string 
包裹宽,单位厘米
可选
height
string 
包裹高,单位厘米
可选
recipient
object 
可选
address
object 
可选
mobile
string 
可选
手机号码,明文或者密文
name
string 
姓名,明文或者密文
可选
phone
string 
电话号码
可选
openAddressId
string 
可选
用来查询收件人详情,需要和orderId匹配使用
sender
object 
可选
mobile
string 
手机号码,明文
可选
name
string 
姓名,明文
可选
phone
string 
电话号码
可选
templateId
string 
电子面单模板ID
可选
示例

返回响应

🟢200成功
application/json
Body
error_code
string 
错误码
必需
error_msg
string 
错误描述
必需
success
string 
请求是否成功
必需
data
object 
必需
waybill
object 
必需
subErrorCode
string 
子错误码
必需

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

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

扫码加入交流群
上一页
批量取号
下一页
取消面单
Built with