纷享销客开发者手册 纷享销客开发者手册
  • APL开发手册
  • PWC开发手册
  • OpenAPI 文档
  • 快速入门
  • API 授权流程
  • API 基础说明
  • OpenAPI
  • 免登集成方案
  • 客户端开发
  • 常见问题
  • OpenApi V1版本 (opens new window)
  • 简体中文
  • English
  • 快速入门
  • API 授权流程
  • API 基础说明
  • OpenAPI
  • 免登集成方案
  • 客户端开发
  • 常见问题
  • OpenApi V1版本 (opens new window)
  • 简体中文
  • English
  • 快速入门

  • API授权流程

  • API基础说明

  • OpenAPI

    • CRM对象接口

    • CRM对象通用接口

    • 通讯录接口

    • 其他接口

      • 任务待办接口

      • 考勤外勤接口

      • 协同审批接口

      • 企业互联接口

      • 消息接口

      • 素材管理接口

      • 网盘接口

      • 营销通接口

        • 查询物料列表
        • 创建物料
        • 删除物料
        • 查询物料详情
        • 更新物料
        • 文件服务

        • ERP接口

        • BI接口

        • 下线接口

    • 免登集成方案

    • 客户端开发

    • 常见问题

    目录

    更新物料

    # 描述

    更新物料

    # 请求说明

    请求方式:POST + application/json

    请求路径:https://${填入所在云的域名}/cgi/crm/v2/material/updateMaterial?thirdTraceId=${随机字符串}

    请求头填写 :参考公共参数填写

    # 请求参数

    参数 类型 是否必填 说明
    data Map 是 数据MAP
      productId String 是 产品id
      isUpdatePicture Boolean 是 是否更新图片
      materialType Int 是 物料类型:1-创建产品(目前只支持产品)
      createProductArg Map 是 新增产品参数, materialType=1时必填
        name String 是 产品名称
        price String 是 价格
        discountPrice String 是 优惠价格
        videoUrl String 是 视频URL,只支持腾讯视频的URL, videoUrl和videoId只能传一个,详情图和视频必传一个
        videoId String 是 视频库的视频ID, videoUrl和videoId只能传一个,详情图和视频必传一个
        summary String 是 产品简介
        tryOutEnable Boolean 是 产品试用:true 关闭 false 打开
        tryOutButtonValue Boolean 是 按钮名称
        formId Boolean 是 表单id
        headPictures List 是 产品封面图,最多传3张,建议尺寸为:750 * 360
          data List 是 图片数据,将图片转换为byte数组
          extension String 是 图片扩展名
        detailPictures List 是 产品详情图,最多传20张,详情图和视频必传一个
          data List 是 图片数据,将图片转换为byte数组
          extension String 是 图片扩展名

    # 请求示例

    {
      "data": {
        "productId": "产品ID",
        "materialType": 1,
        "createProductArg": {
          "summary": "demoData",
          "formId": "demoData",
          "videoUrl": "demoData",
          "tryOutButtonValue": "demoData",
          "price": "demoData",
          "tryOutEnable": true,
          "name": "demoData",
          "discountPrice": "demoData",
          "detailPictures": {
            "extension": "jpg",
            "data": [
              1
            ]
          },
          "videoId": "demoData",
          "headPictures": {
            "extension": "jpg",
            "data": [
              1
            ]
          }
        },
        "isUpdatePicture": false
      }
    }
    

    # 返回参数

    参数 类型 说明
    traceId string 请求唯一ID
    errorDescription string 错误描述
    errorMessage string 错误信息
    errorCode Int 查看错误码

    # 返回示例

    {
      "traceId": "E-O.827xxxxxx",
      "errorDescription": "success",
      "errorMessage": "OK",
      "errorCode": 0
    }
    

    # 注意事项

    • 不能使用返回值的message字段做逻辑判断,errorMessage会有变化;
    查询物料详情
    获取大文件下载签名URL

    ← 查询物料详情 获取大文件下载签名URL →

    • 跟随系统
    • 浅色模式
    • 深色模式
    • 阅读模式