3vjia Technology Products API

产品模块

Operations 43

POST /api/v1/channelAdmin/employeeChannelsAdd 添加单员工多个渠道权限接口 #
POST /api/v1/channelAdmin/employeeChannelsDel 删除单员工多个渠道权限接口 #
POST /api/v1/designmaterial/getByIds 根据素材ID获取素材数据接口 #
POST /api/v1/designmaterial/getByIdsIncludeDel 根据素材ID集合批量获取素材数据接口 #
POST /api/v1/line/oss/getUploadToken 获取线条上传签名接口 #
POST /api/v1/material/deleteMaterial 删除素材接口 #
POST /api/v1/material/listByPage 分页查询素材数据接口 #
POST /api/v1/material/receiveOuterMaterialContent 接收外网模型文件接口 #
POST /api/v1/material/updateMaterialAndProduct 编辑素材和商品接口 #
POST /api/v1/material/updateMaterialImage 编辑素材主图接口 #
POST /api/v1/material/updateMaterialStatus 编辑素材状态接口 #
POST /api/v1/material/updateProductStatus 编辑商品状态接口 #
POST /api/v1/materialBatchSetting/setIs3d 批量设置素材3D启用状态 #
POST /api/v1/materialCategory/addMaterialCategory 添加素材分类接口 #
POST /api/v1/materialCategory/getMaterialCategory 获取素材分类信息接口 #
POST /api/v1/materialCategory/getShopMaterialCategoryList 获取门店素材分类列表接口 #
POST /api/v1/materialDict/brandSeries 根据品牌id获取系列列表 #
POST /api/v1/materialDict/brands 获取素材品牌列表 #
POST /api/v1/materialDict/commonCategories 通用分类(部件属性等) #
POST /api/v1/materialDict/customNewMaterialCategories 获取企业自定义材质分类接口 #
POST /api/v1/materialDict/customNewMaterials 获取企业自定义材质属性接口 #
POST /api/v1/materialDict/dictTree 字典树(属性类别等) #
POST /api/v1/materialDict/listByModelFlag 获取素材类别字典接口 #
POST /api/v1/materialDict/svjNewMaterialCategories 获取新版材质分类接口 #
POST /api/v1/materialDict/svjNewMaterials 获取新版材质属性接口 #
POST /api/v1/materialcategory/deleteMaterialCategory 删除素材分类接口 #
POST /api/v1/materialcategory/getMaterialCategoryList 获取素材分类列表接口 #
POST /api/v1/materialcategory/updateMaterialCategory 编辑素材分类接口 #
POST /api/v1/model/designmaterialmaxfile/list 获取模型处理进度接口 #
POST /api/v1/model/modelfile/create 保存模型文件记录接口 #
POST /api/v1/model/oss/getUploadToken 获取模型上传签名接口 #
POST /api/v1/model/uploadmaterial/addModels 保存模型数据接口 #
POST /api/v1/productMaterial/editModel 编辑成品模型数据接口 #
POST /api/v1/productMaterial/getModel 根据素材ID获取成品类素材数据接口 #
POST /api/v1/roomMaterial/editChartlet 编辑全屋定制贴图数据接口 #
POST /api/v1/roomMaterial/editModel 编辑全屋定制模型数据接口 #
POST /api/v1/shaderupload/getShaderEdiAttribute 获取材质模板编辑JSON接口 #
POST /api/v1/texture/oss/getUploadToken 获取贴图上传签名接口 #
POST /api/v1/texture/upload/uploadDiffuseImageNew 保存贴图文件记录接口 #
POST /api/v1/texture/uploadchartlet/addChartlets 保存贴图数据接口 #
POST /api/v1/upload/line/generateMultiSection 批量保存线条文件接口 #
POST /api/v1/uploadcategory/getProperty 获取旧版材质属性接口 #
POST /api/v1/uploadmaterial/createLines 批量保存线条接口 #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/3vjia-technology-products-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

3vjia-technology-products-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: 3vjia Open Platform Products API
  version: '2026-09-05'
  summary: Home-furnishing 3D cloud design, quotation, order, manufacturing (AIMES/MOS/DMS) and AI operations exposed by the 3vjia (三维家) Open Platform.
  description: Machine-readable description of the 3vjia (三维家 / AiHouse) Open Platform, DERIVED — not published by the provider in this form.
  contact:
    name: 3vjia Open Platform
    url: https://dev.3vjia.com/
servers:
- url: https://open-gateway.3vjia.com
  description: 3vjia Open Platform gateway (current)
- url: https://open.3vjia.com
  description: Legacy open gateway — takes ?sysCode=external&access_token=
security:
- oauth2ClientCredentials: []
tags:
- name: Products
  description: 产品模块
paths:
  /api/v1/channelAdmin/employeeChannelsAdd:
    post:
      operationId: apiV1ChannelAdminEmployeeChannelsAdd
      summary: 添加单员工多个渠道权限接口
      tags:
      - Products
      x-source-documentation: https://dev.3vjia.com/document?apiId=525276161945751580
      x-documentation-category: 产品模块 / 渠道管理
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                addChannelResultList:
                  type: array
                  items:
                    type: object
                    properties:
                      channelId:
                        type: string
                        description: 渠道ID
                      expirationTime:
                        type: string
                        format: date-time
                        description: 权限过期时间,格式:yyyy-MM-dd HH:mm:ss
                    required:
                    - channelId
                    - expirationTime
                  description: 员工渠道信息
                userId:
                  type: string
                  description: 三维家用户ID
              required:
              - userId
            example:
              addChannelResultList:
              - expirationTime: ''
                channelId: ''
              userId: ''
      responses:
        '200':
          description: 成功 / OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: 请求是否成功 / whether the call succeeded
                  code:
                    type: integer
                    description: 结果码 / result code (0 = success)
                  msg:
                    type: string
                    description: 提示信息 / message
                  data:
                    type: object
              example:
                msg: ''
                code: 0
                data: false
                success: false
        '401':
          description: access_token 缺失或已过期 / missing or expired access_token
  /api/v1/channelAdmin/employeeChannelsDel:
    post:
      operationId: apiV1ChannelAdminEmployeeChannelsDel
      summary: 删除单员工多个渠道权限接口
      tags:
      - Products
      x-source-documentation: https://dev.3vjia.com/document?apiId=525277776689872951
      x-documentation-category: 产品模块 / 渠道管理
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                channelIds:
                  type: array
                  items: {}
                  description: 渠道ID列表,为空则移除用户下所有的渠道权限。
                  examples:
                  - '["10008226","10008229"]'
                userId:
                  type: string
                  description: 用户ID
                  examples:
                  - '1101679488'
              required:
              - userId
            example:
              userId: '1101679488'
              channelIds: []
      responses:
        '200':
          description: 成功 / OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: 请求是否成功 / whether the call succeeded
                  code:
                    type: integer
                    description: 结果码 / result code (0 = success)
                  msg:
                    type: string
                    description: 提示信息 / message
                  data:
                    type: object
              example:
                msg: ''
                code: 0
                data: false
                success: false
        '401':
          description: access_token 缺失或已过期 / missing or expired access_token
  /api/v1/designmaterial/getByIds:
    post:
      operationId: apiV1DesignmaterialGetByIds
      summary: 根据素材ID获取素材数据接口
      tags:
      - Products
      x-source-documentation: https://dev.3vjia.com/document?apiId=472780169510203437
      x-documentation-category: 产品模块 / 素材数据
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                ids:
                  type: array
                  items: {}
                  description: 素材id数组
              required:
              - ids
            example:
              ids: []
      responses:
        '200':
          description: 成功 / OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: 请求是否成功 / whether the call succeeded
                  code:
                    type: integer
                    description: 结果码 / result code (0 = success)
                  msg:
                    type: string
                    description: 提示信息 / message
                  data:
                    type: object
                    properties:
                      a3dSource:
                        type: string
                        description: a3d路径
                      author:
                        type: string
                        description: 上传用户
                      belongType:
                        type: integer
                        format: int32
                        description: 所属类型:1门店,2工厂
                      brickId:
                        type: string
                      categoryId:
                        type: integer
                        format: int32
                        description: 类别编号
                      chartletCode:
                        type: string
                        description: 贴图特征码
                      classification:
                        type: integer
                        format: int32
                        description: 素材类别,1-模型,2-贴图,3-线条
                      color:
                        type: string
                        description: 素材颜色
                      contentUrl:
                        type: string
                        description: content路径
                      costPrice:
                        type: number
                        format: double
                        description: 成本价
                      creatorId:
                        type: string
                        description: 创建者id
                      deptId:
                        type: string
                        description: 部门Id
                      depthDefault:
                        type: string
                        description: 橱衣柜深默认值
                      depthMax:
                        type: number
                        format: double
                        description: 橱衣柜深最大值
                      depthMin:
                        type: number
                        format: double
                        description: 橱衣柜深最小值
                      designCode:
                        type: string
                        description: 部件编号(定制专用)
                      doorTypeSetting:
                        type: integer
                        format: int32
                        description: 配置门板开关,0位不选中,1为选中
                      freeCategoryId:
                        type: integer
                        format: int32
                        description: 素材自定义分类
                      heightDefault:
                        type: string
                        description: 橱衣柜高默认值
                      heightMax:
                        type: number
                        format: double
                        description: 橱衣柜高最大值
                      heightMin:
                        type: number
                        format: double
                        description: 橱衣柜高最小值
                      holeLength:
                        type: number
                        format: double
                        description: 开孔尺寸长
                      holeWidth:
                        type: number
                        format: double
                        description: 开孔尺寸宽
                      id:
                        type: string
                        description: 素材关联淘宝企业表的id
                      imagePath:
                        type: string
                        description: 图片路径
                      is3d:
                        type: integer
                        format: int32
                        description: 是否在3d设计软件显示1显示0不显示
                      isA3d:
                        type: string
                        description: 是否A3D
                      isBrandShare:
                        type: integer
                        format: int32
                        description: 素材是否共享品牌馆业务,null,0未上架,1上架,2待审核,3未通过
                      isBumpMap:
                        type: integer
                        format: int32
                        description: 是否凹凸图0否1是
                      isDelete:
                        type: integer
                        format: int32
                        description: 是否删除
                      isHasProduct:
                        type: integer
                        format: int32
                        description: 素材是否有商品
                      isOut:
                        type: integer
                        format: int32
                        description: “淘汰”状态0正常1淘汰
                      isPublic:
                        type: integer
                        format: int32
                        description: 是否公用
                      isQuality:
                        type: string
                        description: 是否优质素材:0优质素材,1普通素材
                      isRelate:
                        type: integer
                        format: int32
                        description: 标识该素材是否有关联到某个分组中,添加关联为1,取消关联为0,默认为0
                      isRender:
                        type: integer
                        format: int32
                        description: 是否可渲染,0不可渲染,1可渲染
                      isShare:
                        type: integer
                        format: int32
                        description: 替换材质
                      isTop:
                        type: integer
                        format: int32
                        description: 是否置顶0:否1:是默认是0
                      isUnit:
                        type: integer
                        format: int32
                        description: 是否单元,3D橱衣柜专用1是,0否
                      isnodes:
                        type: integer
                        format: int32
                        description: 标识是否支持多节点,0-否(默认),1-是
                      item:
                        type: string
                        description: 淘宝商品ID
                      leafType:
                        type: string
                        description: 类型字段包含选项:“掩门”、“翻门”、“抽面”、“假门”、“假抽”、“封板”、“装饰板”
                      lightProperty:
                        type: string
                        description: 灯光属性
                      materialAttribute:
                        type: string
                        description: 属性类别
                      materialBallType:
                        type: integer
                        format: int32
                        description: 是否新材质默认值为1
                      materialCategory:
                        type: string
                        description: 素材分类
                      materialId:
                        type: string
                        description: 素材Id
                      materialName:
                        type: string
                        description: 素材名称
                      materialType:
                        type: string
                        description: 素材类型
                      materialrhId:
                        type: string
                        description: 材质球渲染记录id
                      modelDepth:
                        type: number
                        format: double
                        description: 模型深度
                      modelFlag:
                        type: integer
                        format: int32
                        description: 模型标志1表示摆摆看,2表示贴贴看3表示加加看
                      modifyTime:
                        type: string
                      modifyUserId:
                        type: string
                      openDirection:
                        type: string
                        description: 开门方向分为:左开/右开(对应掩门)、上开/下开(对应翻门)、前开(对应抽面)
                      organId:
                        type: string
                        description: 发布商家
                      orientation:
                        type: integer
                        format: int32
                        description: 朝向左开为1,右开为2
                      parts:
                        type: string
                        description: 部件属性
                      picHeight:
                        type: number
                        format: double
                        description: 高
                      picHeight_Bak:
                        type: number
                        format: double
                        description: 图片高
                      picLength:
                        type: number
                        format: double
                        description: 长
                      picLength_Bak:
                        type: number
                        format: double
                        description: 图片长
                      picSize:
                        type: string
                        description: 素材图片的尺寸大小,例如:806A504
                      picWidth:
                        type: number
                        format: double
                        description: 宽
                      picWidth_Bak:
                        type: number
                        format: double
                        description: 图片宽
                      placeHeight:
                        type: string
                        description: 放置高度
                      placeRule:
                        type: string
                        description: 放置规则
                      postTime:
                        type: string
                        description: 上传时间
                      productId:
                        type: string
                        description: 产品Id
                      property:
                        type: string
                        description: 材质属性
                      publicCategoryId:
                        type: integer
                        format: int32
                        description: 公共库分类ID
                      rawMaterialType:
                        type: string
                        description: 原材料类型
                      remark:
                        type: string
                        description: 备注
                      replaceImg:
                        type: string
                        description: 替换贴图,1是,0否
                      retailPrice:
                        type: number
                        format: double
                        description: 零售价
                      salePrice:
                        type: number
                        format: double
                        description: 售价
                      shareStatus:
                        type: integer
                        format: int32
                        description: 分享状态:0:未分享(默认),1:已分享,2:已下架
                      shareTime:
                        type: string
                        description: 分享时间
                      shareTopTime:
                        type: string
                        description: 分享置顶时间
                      shopId:
                        type: string
                        description: 门店id
                      sku:
                        type: string
                        description: 淘宝skuId
                      sortNumber:
                        type: integer
                        format: int32
                        description: 序号
                      sprungRoofType:
                        type: integer
                        format: int32
                        description: 顶墙上传类型1模型2贴图3收边条
                      subParts:
                        type: string
                        description: 子部件属性
                      taperStatus:
                        type: integer
                        format: int32
                        description: 减面操作状态
                      tenantId:
                        type: string
                        description: 租户id
                      thumbPath:
                        type: string
                        description: '''截面库-解析xmlContent对应的图片路径-缩略图'''
                      useArea:
                        type: string
                        description: 使用区域
                      useCategory:
                        type: string
                        description: 使用分类
                      useStage:
                        type: string
                        description: 使用阶段
                      version:
                        type: integer
                        format: int32
                      version1:
                        type: integer
                        format: int32
                      versionTime:
                        type: string
                        description: content的修改时间
                      wccId:
                        type: string
                        description: 欧派产品编号
                      wholeSalePrice:
                        type: number
                        format: double
                        description: 批发价
                      widthDefault:
                        type: string
                        description: 橱衣柜宽默认值
                      widthMax:
                        type: number
                        format: double
                        description: 橱衣柜宽最大值
                      widthMin:
                        type: number
                        format: double
                        description: 橱衣柜宽最小值
                      xmlContentUrl:
                        type: string
                        description: xmlContent路径
              example:
                msg: ''
                code: 0
                data:
                - imagePath: ''
                  sortNumber: 0
                  modifyUserId: ''
                  is3d: 0
                  xmlContentUrl: ''
                  useArea: ''
                  rawMaterialType: ''
                  postTime: ''
                  modifyTime: ''
                  modelFlag: 0
                  isRender: 0
                  property: ''
                  materialBallType: 0
                  id: ''
                  shopId: ''
                  sku: ''
                  brickId: ''
                  item: ''
                  isHasProduct: 0
                  lightProperty: ''
                  productId: ''
                  author: ''
                  leafType: ''
                  deptId: ''
                  wccId: ''
                  isnodes: 0
                  picSize: ''
                  classification: 0
                  materialId: ''
                  materialAttribute: ''
                  materialCategory: ''
                  version: 0
                  publicCategoryId: 0
                  subParts: ''
                  materialName: ''
                  isTop: 0
                  openDirection: ''
                  isQuality: ''
                  sprungRoofType: 0
                  isShare: 0
                  parts: ''
                  isOut: 0
                  organId: ''
                  useStage: ''
                  widthDefault: ''
                  shareTopTime: ''
                  a3dSource: ''
                  doorTypeSetting: 0
                  color: ''
                  useCategory: ''
                  creatorId: ''
                  isBrandShare: 0
                  remark: ''
                  isBumpMap: 0
                  isA3d: ''
                  isRelate: 0
                  heightDefault: ''
                  taperStatus: 0
                  versionTime: ''
                  isPublic: 0
                  thumbPath: ''
                  belongType: 0
                  orientation: 0
                  chartletCode: ''
                  freeCategoryId: 0
                  isDelete: 0
                  isUnit: 0
                  materialType: ''
                  materialrhId: ''
                  replaceImg: ''
                  placeHeight: ''
                  placeRule: ''
                  contentUrl: ''
                  depthDefault: ''
                  version1: 0
                  shareTime: ''
                  tenantId: ''
                  designCode: ''
                  categoryId: 0
                  shareStatus: 0
                success: false
        '401':
          description: access_token 缺失或已过期 / missing or expired access_token
  /api/v1/designmaterial/getByIdsIncludeDel:
    post:
      operationId: apiV1DesignmaterialGetByIdsIncludeDel
      summary: 根据素材ID集合批量获取素材数据接口
      tags:
      - Products
      x-source-documentation: https://dev.3vjia.com/document?apiId=557922168223166473
      x-documentation-category: 产品模块 / 素材数据
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                ids:
                  type: array
                  items: {}
                  description: id集合
            example:
              ids: []
      responses:
        '200':
          description: 成功 / OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: 请求是否成功 / whether the call succeeded
                  code:
                    type: integer
                    description: 结果码 / result code (0 = success)
                  msg:
                    type: string
                    description: 提示信息 / message
                  data:
                    type: object
                    properties:
                      a3dsource:
                        type: string
                        description: a3d路径
                      author:
                        type: string
                        description: 上传用户
                      belongtype:
                        type: integer
                        format: int32
                        description: 所属类型:1门店,2工厂
                      brickid:
                        type: string
                      categoryid:
                        type: integer
                        format: int32
                        description: 类别编号
                      classification:
                        type: integer
                        format: int32
                        description: 素材类别,1-模型,2-贴图,3-线条
                      color:
                        type: string
                        description: 素材颜色
                      content:
                        type: string
                        description: 内容
                      contentCdnUrl:
                        type: string
                        description: 内容CDN url
                      contentCloudUrl:
                        type: string
                        description: 内容云url
                      contentUrl:
                        type: string
                        description: 内容url
                      costprice:
                        type: number
                        format: bigdecimal
                        description: 成本价
                      createTime:
                        type: string
                        format: date-time
                        description: 创建时间
                      creatorId:
                        type: string
                        description: 创建者id
                      depthdefault:
                        type: string
                        description: 橱衣柜深默认值
                      depthmax:
                        type: number
                        format: bigdecimal
                        description: 橱衣柜深最大值
                      depthmin:
                        type: number
                        format: bigdecimal
                        description: 橱衣柜深最小值
                      deptid:
                        type: string
                        description: 部门Id
                      designcode:
                        type: string
                      doortypesetting:
                        type: integer
                        format: int32
                        description: 配置门板开关,0位不选中,1为选中
                      expandattrib:
                        type: string
                        description: 使用XML描述,MYSQL已废弃
                      freecategoryid:
                        type: integer
                        format: int32
                        description: 素材自定义分类
                      heightdefault:
                        type: string
                      heightmax:
                        type: number
                        format: bigdecimal
                        description: 橱衣柜高最大值
                      heightmin:
                        type: number
                        format: bigdecimal
                        description: 橱衣柜高最小值
                      holelength:
                        type: integer
                        format: int32
                        description: 开孔尺寸长
                      holewidth:
                        type: integer
                        format: int32
                        description: 开孔尺寸宽
                      id:
                        type: string
                        description: 主键id
                      imagepath:
                        type: string
                        description: 图片路径
                      is3d:
                        type: integer
                        format: int32
                        description: 是否在3d设计软件显示 1显示 0 不显示
                      isa3d:
                        type: string
                        description: 是否A3D
                      isbrandshare:
                        type: integer
                        format: int32
                      isbumpmap:
                        type: integer
                        format: int32
                        description: 是否凹凸图 0否 1是
                      isdelete:
                        type: integer
                        format: int32
                        description: 是否删除
                      ishasproduct:
                        type: integer
                        format: int32
                        description: 素材是否有商品
                      isnodes:
                        type: integer
                        format: int32
                        description: 标识是否支持多节点,0-否(默认),1-是
                      ispublic:
                        type: integer
                        format: int32
                        description: 是否公用
                      isquality:
                        type: integer
                        format: int32
                      isrelate:
                        type: integer
                        format: int32
                        description: 标识该素材是否有关联到某个分组中,添加关联为1 ,取消关联为0,默认为0
                      isrender:
                        type: integer
                        format: int32
                        description: 是否可渲染,0不可渲染,1可渲染
                      isshare:
                        type: integer
                        format: int32
                        description: 替换材质
                      istop:
                        type: integer
                        format: int32
                        description: 是否置顶 0:否  1:是  默认是0
                      isunit:
                        type: integer
                        format: int32
                        description: 是否单元,3D橱衣柜专用 1是,0否
                      leaftype:
                        type: string
                        description: 类型:0掩门,1 抽面,2翻门,3假门,10假抽,11封板,12装饰板等,可存多值
                      lightproperty:
                        type: string
                        description: 灯光属性
                      materialCategoryName:
                        type: string
                        description: 素材分类名称
                      materialattribute:
                        type: string
                        description: 属性类别
                      materialcategory:
                        type: string
                        description: 素材分类
                      materialname:
                        type: string
                        description: 素材名称
                      materialrhid:
                        type: string
                        description: 材质球渲染记录id
                      materialtype:
                        type: string
                        description: 素材类型
                      modeldepth:
                        type: integer
                        format: int64
                      modelflag:
                        type: integer
                        format: int32
                 

# --- truncated at 32 KB (250 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/3vjia-technology/refs/heads/main/openapi/3vjia-technology-products-api-openapi.yml