小红书 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": "zto",
    "sender": {
        "address": {
            "city": "",
            "detail": "",
            "district": "",
            "province": "",
            "town": ""
        },
        "mobile": "",
        "name": "",
        "phone": ""
    },
    "tradeOrderInfoList": [
        {
            "logisticsServices": "{\"增值服务1的code\":{增值服务1的值},\"增值服务2的code\":{增值服务2的值} }",
            "objectId": "1",
            "orderInfo": {
                "orderChannelsType": "XIAO_HONG_SHU",
                "tradeOrderList": [
                    "string"
                ],
                "buyerMemo": [
                    "string"
                ],
                "sellerMemo": [
                    "string"
                ]
            },
            "packageInfo": {
                "id": "",
                "items": [
                    {
                        "count": "",
                        "name": "",
                        "specification": ""
                    }
                ],
                "volume": "",
                "weight": "",
                "length": "",
                "width": "",
                "height": "",
                "totalPackagesCount": "",
                "packagingDescription": "",
                "goodsDescription": "家具",
                "goodValue": ""
            },
            "recipient": {
                "address": {
                    "city": "",
                    "detail": "",
                    "district": "",
                    "province": "",
                    "town": ""
                },
                "mobile": "",
                "name": "",
                "phone": "",
                "openAddressId": ""
            },
            "templateId": "1"
        }
    ],
    "extraInfo": "",
    "customerCode": "",
    "brandCode": "",
    "productCode": "",
    "callDoorPickUp": "",
    "doorPickUpTime": "",
    "doorPickUpEndTime": "",
    "sellerName": "",
    "branchCode": ""
}'
响应示例响应示例
{
  "error_code": "0",
  "success": "true",
  "error_msg": "",
  "data": {
    "wayBillList": [
      {
        "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 
快递公司编码
必需
sender
object 
必需
寄件人地址必须和订购关系的地址保持一致
address
object 
必需
mobile
string 
手机号码,明文
可选
name
string 
姓名,明文
必需
phone
string 
电话号码
可选
tradeOrderInfoList
array [object {6}] 
必需
请求面单列表(上限10个)
logisticsServices
string 
可选
物流服务,见对接说明附录物流增值服务
objectId
string 
可选
请求ID,保证一次批量请求不重复,返回结果基于该值取到对应的快递单号
orderInfo
object 
必需
packageInfo
object 
必需
recipient
object 
必需
收件人信息,支持明文、密文、openAddressId + tradeOrderList三种
templateId
string 
电子面单模板ID
可选
extraInfo
string 
可选
拓展信息,特殊场景下使
customerCode
string 
可选
月结卡号,直营快递公司一般要求必填
brandCode
string 
可选
品牌编码,顺丰要求必填
productCode
string 
可选
产品编码,仅部分快递公司支持传入,见对接说明附录物流产品类型
callDoorPickUp
string 
可选
是否预约上门,仅部分快递公司支持传入
doorPickUpTime
string 
可选
预约上门取件时间,'yyyy-MM-dd HH:mm:ss',仅部分快递公司支持传入
doorPickUpEndTime
string 
可选
预约上门取件截止时间,'yyyy-MM-dd HH:mm:ss',仅部分快递公司支持传入
sellerName
string 
必需
店铺名称,对参数内容没有限制
branchCode
string 
可选
网点编码,加盟型快递公司一般要求必填
示例

返回响应

🟢200成功
application/json
Body
error_code
string 
返回值code
必需
success
string 
请求是否成功
必需
error_msg
string 
错误信息
必需
data
object 
必需
wayBillList
array [object {7}] 
面单列表
必需
subErrorCode
string 
子错误码
必需

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

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

扫码加入交流群
上一页
查询电子面单模板列表
下一页
更新面单
Built with