3vjia Technology

3vjia Technology Design Schemes API

方案模块

GitHub OpenAPI

Operations 19

POST /api/schemecategory/updateSchemeCategory 编辑方案分类接口 #
POST /api/taggroup/page 分页查询标签组和标签信息 #
POST /api/v1/Goods/getAllPage 获取方案岛所有商品方案数据接口 #
POST /api/v1/Goods/getHomePage 获取商品方案 #
POST /api/v1/admin/schemeDelete 批量删除方案接口 #
POST /api/v1/ai/scheme/project/listByPage 查询方案秀方案列表接口 #
POST /api/v1/designscheme/copyScheme 复制方案接口 #
POST /api/v1/designschemesland/getFilterDictionary 获取方案岛分类过滤字典接口 #
POST /api/v1/goods/listPageByModityDate 根据修改时间获取商品方案列表 #
POST /api/v1/quotation/getSchemeProductPrice 获取方案成品清单接口 #
POST /api/v1/scheme/getScheme 获取方案详细数据接口 #
POST /api/v1/scheme/getSchemeListByPage 获取方案列表v1接口 #
POST /api/v1/scheme/getSchemeProduct 获取方案产品清单接口 #
POST /api/v1/scheme/getSchemeRender 获取方案效果图列表接口 #
POST /api/v1/schemeCategory/getSchemeCategoryList 获取方案分类列表接口 #
POST /api/v1/schemecategory/createSchemeCategory 添加方案分类接口 #
POST /api/v1/schemecategory/deleteSchemeCategory 删除方案分类接口 #
POST /api/v1/schemesLand/getGoodsDetail 获取方案岛商品方案详细信息接口 #
POST /api/v2/scheme/getSchemeListByPage 获取方案列表v2接口 #

Documentation

📖
Documentation
https://dev.3vjia.com/v1/document
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/3vjia-technology/refs/heads/main/authentication/3vjia-technology-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/3vjia-technology/refs/heads/main/rate-limits/3vjia-technology-rate-limits.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/3vjia-technology/refs/heads/main/openapi/3vjia-technology-design-schemes-api-openapi.yml

Other Resources

🔗
DeveloperPortal
https://dev.3vjia.com/
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/3vjia-technology/refs/heads/main/asyncapi/3vjia-technology-webhooks.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/3vjia-technology/refs/heads/main/errors/3vjia-technology-problem-types.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/3vjia-technology/refs/heads/main/conventions/3vjia-technology-conventions.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/3vjia-technology/refs/heads/main/data-model/3vjia-technology-data-model.yml
🔗
ToolCrosswalk
https://raw.githubusercontent.com/api-evangelist/3vjia-technology/refs/heads/main/mcp/3vjia-technology-tool-crosswalk.yml

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-design-schemes-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.

GitHub Google LinkedIn

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

OpenAPI Specification

3vjia-technology-design-schemes-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: 3vjia Open Platform Design Schemes 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: Design Schemes
  description: 方案模块
paths:
  /api/schemecategory/updateSchemeCategory:
    post:
      operationId: apiSchemecategoryUpdateSchemeCategory
      summary: 编辑方案分类接口
      tags:
      - Design Schemes
      x-source-documentation: https://dev.3vjia.com/document?apiId=475026463813349465
      x-documentation-category: 方案模块 / 方案分类
      description: 编辑方案分类
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                categoryCode:
                  type: string
                  description: 分类代码，可自定义的代码，不超过32个字符
                categoryId:
                  type: string
                  description: 要修改的分类的ID
                categoryName:
                  type: string
                  description: 分类名称，不能超过512个字符
                hasChildren:
                  type: integer
                  format: int32
                  description: 是否有子分类，1=有，0=无，默认0
                parentId:
                  type: string
                  description: 分类所属的上级ID
                sortCode:
                  type: integer
                  format: int32
                  description: 分类排序码，会影响显示顺序，默认为0
            example:
              hasChildren: 0
              categoryCode: ''
              categoryName: ''
              sortCode: 0
              parentId: ''
              categoryId: ''
      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: true
                success: true
        '401':
          description: access_token 缺失或已过期 / missing or expired access_token
  /api/taggroup/page:
    post:
      operationId: apiTaggroupPage
      summary: 分页查询标签组和标签信息
      tags:
      - Design Schemes
      x-source-documentation: https://dev.3vjia.com/document?apiId=744248039480377472
      x-documentation-category: 方案模块 / 方案岛
      description: 分页查询标签组信息
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                pageIndex:
                  type: integer
                  format: int32
                pageSize:
                  type: integer
                  format: int32
                sorts:
                  type: array
                  items:
                    type: object
                    properties:
                      sortField:
                        type: string
                        description: 排序字段
                      sortType:
                        type: string
                        description: 排序类型，asc或者desc
                  description: "This is List Type  \n查询排序集合"
                where:
                  type: object
                  properties:
                    groupStatus:
                      type: string
                      description: 分组状态：enable-启用，disable-禁用
                    groupType:
                      type: integer
                      format: int32
                      description: 标签组类型：0-全屋空间案例库，1-营销活动套餐库，2-卫浴空间案例库，3-阳台空间案例库，4-全场景高端定制方案，5-卫浴个性空间案例库，6-淋浴房空间案例库
                    isShowDisabledTags:
                      type: integer
                      format: int32
                      description: 是否显示禁用标签项，0-不显示，1-显示
                  description: 分页查询标签分组
            example:
              pageSize: 0
              pageIndex: 0
              where:
                groupType: 0
                groupStatus: ''
                isShowDisabledTags: 0
              sorts:
              - sortType: ''
                sortField: ''
      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:
                      pageIndex:
                        type: integer
                        format: int32
                      pageSize:
                        type: integer
                        format: int32
                      recordCount:
                        type: integer
                        format: int32
                      result:
                        type: array
                        items:
                          type: object
                          properties:
                            createDate:
                              type: string
                              description: 创建时间
                            creator:
                              type: string
                              description: 创建人
                            groupName:
                              type: string
                              description: 分组名称
                            groupStatus:
                              type: string
                              description: 是否启用：enable-启用，disable-禁用
                            groupType:
                              type: integer
                              format: int32
                              description: 标签组类型：0-全屋空间案例库，1-营销活动套餐库，2-卫浴空间案例库，3-阳台空间案例库，4-全场景高端定制方案，5-卫浴个性空间案例库，6-淋浴房空间案例库
                            id:
                              type: string
                              description: 主键ID
                            imagePath:
                              type: string
                              description: “不限”选项的封面图
                            isDelete:
                              type: integer
                              format: int32
                              description: 是否删除
                            modify:
                              type: string
                              description: 修改人
                            modifyDate:
                              type: string
                              description: 修改时间
                            organId:
                              type: string
                              description: 机构ID
                            sortNo:
                              type: integer
                              format: int32
                              description: 排序
                            tags:
                              type: array
                              items:
                                type: object
                                properties:
                                  createDate:
                                    type: string
                                    description: 创建时间
                                  creator:
                                    type: string
                                    description: 创建人
                                  id:
                                    type: string
                                    description: 标签ID
                                  imagePath:
                                    type: string
                                    description: 标签图片
                                  modify:
                                    type: string
                                    description: 修改人
                                  modifyDate:
                                    type: string
                                    description: 修改时间
                                  organId:
                                    type: string
                                    description: 机构ID
                                  sortNo:
                                    type: integer
                                    format: int32
                                    description: 排序
                                  tagName:
                                    type: string
                                    description: 标签名称
                                  tagStatus:
                                    type: string
                                    description: 标签状态
                                  tenantId:
                                    type: string
                                    description: tenantId租户id(兼容)
                              description: 标签表OutputDto
                        description: 标签分组结果
              example:
                msg: ''
                code: 0
                data:
                  recordCount: 0
                  pageSize: 0
                  result:
                  - creator: ''
                    groupType: 0
                    modifyDate: ''
                    imagePath: ''
                    isDelete: 0
                    groupStatus: ''
                    tags:
                    - creator: ''
                      modifyDate: ''
                      tagStatus: ''
                      imagePath: ''
                      tagName: ''
                      sortNo: 0
                      modify: ''
                      tenantId: ''
                      organId: ''
                      id: ''
                      createDate: ''
                    sortNo: 0
                    modify: ''
                    groupName: ''
                    organId: ''
                    id: ''
                    createDate: ''
                  pageIndex: 0
                success: false
        '401':
          description: access_token 缺失或已过期 / missing or expired access_token
  /api/v1/Goods/getAllPage:
    post:
      operationId: apiV1GoodsGetAllPage
      summary: 获取方案岛所有商品方案数据接口
      tags:
      - Design Schemes
      x-source-documentation: https://dev.3vjia.com/document?apiId=505401177635147811
      x-documentation-category: 方案模块 / 方案岛
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                pageIndex:
                  type: integer
                  format: int32
                pageSize:
                  type: integer
                  format: int32
                sorts:
                  type: array
                  items:
                    type: object
                    properties:
                      sortField:
                        type: string
                      sortType:
                        type: string
                  description: 'ThisisListType

                    查询排序集合'
                where:
                  type: object
                  properties:
                    activitiesName:
                      type: string
                      description: 相关活动关键字
                    atlasStatus:
                      type: integer
                      format: int32
                      description: 图谱状态，-1为删除，0为入库，1为上架或者发布，2为下架，不传则查询全部
                    begCreateDate:
                      type: string
                      description: 创建时间开始
                    begDelDate:
                      type: string
                      description: 删除时间开始
                    begSchemeSized:
                      type: number
                      format: double
                      description: 面积开始
                    begStatusDate:
                      type: string
                      description: 状态时间开始
                    categorys:
                      type: object
                      description: 类目数组
                    endCreateDate:
                      type: string
                      description: 创建时间结束
                    endDelDate:
                      type: string
                      description: 删除时间结束
                    endSchemeSized:
                      type: number
                      format: double
                      description: 面积结束
                    endStatusDate:
                      type: string
                      description: 状态时间结束
                    goodsName:
                      type: string
                      description: 名称
                    goodsStatus:
                      type: string
                      description: 商品状态empty：草稿checking：上架审核reject：上架驳回upShelves：上架offShelves：下架
                    goodsType:
                      type: string
                      description: 商品类型，scheme=全景方案,excellent=优秀方案
                    isActivities:
                      type: integer
                      format: int32
                      description: 是否查询企业活动投稿方案0：查看非投稿1：查看投稿null：查看全部
                    isHotSell:
                      type: integer
                      format: int32
                      description: 是否热销方案
                    isUpShelves:
                      type: integer
                      format: int32
                      description: 是否查询已上架方案0：查询未上架方案（包含上架、参与活动的方案）1：查询已上架方案（未上架、未参与活动的方案）null：查询全部
                    keyword:
                      type: string
                      description: 方案名称或者产品型号模糊搜索
                    organId:
                      type: string
                      description: 机构id,前端有需求免登陆指定机构id获取方案列表
                    price:
                      type: integer
                      format: int32
                      description: 售价,0：免费，1：付费
                    productNo:
                      type: string
                      description: 产品型号
                    schemeId:
                      type: string
                      description: 3D方案id
                    schemeRoom:
                      type: string
                      description: 空间
                    schemeStyle:
                      type: string
                      description: 风格
                    schemeType:
                      type: string
                      description: 户型
                    tagId:
                      type: string
                      description: 标签ID
                    tagIdList:
                      type: array
                      items: {}
                      description: 'ThisisListType

                        标签id集合'
                    tenantId:
                      type: string
                      description: tenantId租户id(兼容)
                    userId:
                      type: string
                      description: 用户id
                    userName:
                      type: string
                      description: 设计师帐号，精确查询
                  description: '商品方案表SearchInputDto

                    分页查询条件'
            example:
              pageSize: 0
              pageIndex: 0
              where:
                schemeType: ''
                tagId: ''
                endCreateDate: ''
                begCreateDate: ''
                schemeId: ''
                endDelDate: ''
                endStatusDate: ''
                price: 0
                isHotSell: 0
                schemeRoom: ''
                keyword: ''
                goodsName: ''
                productNo: ''
                categorys: ''
                atlasStatus: 0
                schemeStyle: ''
                isUpShelves: 0
                userName: ''
                userId: ''
                activitiesName: ''
                goodsType: ''
                begStatusDate: ''
                isActivities: 0
                goodsStatus: ''
                tenantId: ''
                organId: ''
                begDelDate: ''
                tagIdList: []
              sorts:
              - sortType: ''
                sortField: ''
      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:
                      pageIndex:
                        type: integer
                        format: int32
                      pageSize:
                        type: integer
                        format: int32
                      recordCount:
                        type: integer
                        format: int32
                      result:
                        type: array
                        items:
                          type: object
                          properties:
                            atlasId:
                              type: string
                              description: 图谱ID
                            atlasStatus:
                              type: integer
                              format: int32
                              description: 图谱状态，-1为删除，0为入库，1为上架或者发布，2为下架，不传则查询全部
                            buyNums:
                              type: integer
                              format: int32
                              description: 购买数量
                            buyScores:
                              type: integer
                              format: int32
                              description: 购买分数
                            checkDate:
                              type: string
                              description: 方案审核时间
                            checkUserId:
                              type: string
                              description: 方案审核人用户id
                            checkUserNickName:
                              type: string
                              description: 方案审核人用户id
                            commentNums:
                              type: integer
                              format: int32
                              description: 评论数量
                            content:
                              type: string
                              description: 商品介绍
                            coverPageFileId:
                              type: string
                              description: 封面文件ID
                            coverPageUrl:
                              type: string
                              description: 封面地址
                            createDate:
                              type: string
                              description: 创建时间
                            creator:
                              type: string
                              description: 创建人
                            favoriteNums:
                              type: integer
                              format: int32
                              description: 收藏数量
                            goodsName:
                              type: string
                              description: 名称
                            goodsStatus:
                              type: string
                              description: 商品状态
                            goodsStatusDesc:
                              type: string
                              description: 商品状态显示文本
                            goodsType:
                              type: string
                              description: 商品类型
                            goodsTypeDesc:
                              type: string
                              description: 商品类型
                            hasSmartRoom:
                              type: integer
                              format: int32
                              description: 是否有智能样板间
                            id:
                              type: string
                              description: 商品ID
                            isBuy:
                              type: boolean
                              description: 是否购买（使用权）
                            isBuySource:
                              type: boolean
                              description: 是否已购买了源文件
                            isFavorite:
                              type: boolean
                              description: 是否已收藏：true=是false=否
                            isHotSell:
                              type: integer
                              format: int32
                              description: 是否热销方案1=热销（优秀方案）
                            isPraise:
                              type: boolean
                              description: 是否已点赞：true=是false=否
                            lookNums:
                              type: integer
                              format: int32
                              description: 浏览数量
                            modifyDate:
                              type: string
                              description: 最后修改时间(删除时间）
                            orderNum:
                              type: integer
                              format: int32
                              description: 九牧定制:下单量
                            organId:
                              type: string
                              description: 机构ID
                            praiseNums:
                              type: integer
                              format: int32
                              description: 点赞数量
                            price:
                              type: integer
                              format: int32
                              description: 售价
                            relGoodIds:
                              type: array
                              items: {}
                              description: 'ThisisListType

                                关联商品Id列表'
                            schemeDepthImageUrl:
                              type: string
                              description: 深度图地址
                            schemeId:
                              type: string
                              description: 方案ID
                            schemeSized:
                              type: number
                              format: double
                              description: 面积
                            schemeSizedStr:
                              type: string
                              description: 面积
                            schemeStyle:
                              type: string
                              description: 风格
                            schemeStyleDesc:
                              type: string
                              description: 风格显示文本
                            schemeType:
                              type: string
                              description: 户型
                            schemeTypeDesc:
                              type: string
                              description: 户型显示文本
                            schemeVerion:
                              type: string
                              description: 方案版本号
                            schemeVrUrl:
                              type: string
                              description: 全景图链接地址
                            sourcePrice:
                              type: integer
                              format: int32
                              description: 源文件售价：0=免费，-1=不销售
                            statusDate:
                              type: string
                              description: 状态时间
                            statusReason:
                              type: string
                              description: 状态原因
                            tenantId:
                              type: string
                              description: tenantId租户id(兼容)
                            topSortCode:
                              type: integer
                              format: int64
                              description: 置顶排序序号（序号越大，越前）
                            userId:
                              type: string
                              description: 归属用户ID
                            userImageUrl:
                              type: string
                              description: 归属用户头像图片地址
                            userName:
                              type: string
                              description: 归属用户帐号
                            userNickName:
                              type: string
                              description: 归属用户名称
                        description: 商品方案表列表OutputDto
              example:
                msg: ''
                code: 0
                data:
                  recordCount: 0
                  pageSize: 0
                  result:
                  - isBuy: false
                    statusDate: ''
                    userImageUrl: ''
                    praiseNums: 0
                    schemeType: ''
                    statusReason: ''
                    price: 0
                    isBuySource: false
                    checkUserNickName: ''
                    id: ''
                    userNickName: ''
                    goodsName: ''
                    relGoodIds: []
                    modifyDate: ''
                    schemeSizedStr: ''
                    coverPageFileId: ''
                    lookNums: 0
                    goodsType: ''
                    goodsTypeDesc: ''
                    schemeStyleDesc: ''
                    favoriteNums: 0
                    organId: ''
                    isFavorite: false
                    schemeVerion: ''
                    schemeDepthImageUrl: ''
                    atlasId: ''
                    checkUserId: ''
                    orderNum: 0
                    schemeId: ''
                    schemeTypeDesc: ''
                    buyNums: 0
                    content: ''
                    sourcePrice: 0
                    isHotSell: 0
                    createDate: ''
                    atlasStatus: 0
                    creator: ''
                    schemeStyle: ''
                    hasSmartRoom: 0
                    coverPageUrl: ''
                    topSortCode: 0
                    checkDate: ''
                    goodsStatusDesc: ''
                    userName: ''
                    userId: ''
                    buyScores: 0
                    commentNums: 0
                    goodsStatus: ''
                    schemeVrUrl: ''
                    tenantId: ''
                    isPraise: false
                  pageIndex: 0
                success: false
        '401':
          description: access_token 缺失或已过期 / missing or expired access_token
  /api/v1/Goods/getHomePage:
    post:
      operationId: apiV1GoodsGetHomePage
      summary: 获取商品方案
      tags:
      - Design Schemes
      x-source-documentation: https://dev.3vjia.com/document?apiId=744249709870334034
      x-documentation-category: 方案模块 / 方案岛
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                filterDesign:
                  type: boolean
                  description: 是否过滤design方案
                pageIndex:
                  type: integer
                  format: int32
                pageSize:
                  type: integer
                  format: int32
                sorts:
                  type: array
                  items:
                    type: object
                    properties:
                      sortField:
                        type: string
                        description: 排序字段
                      sortType:
                        type: string
                        description: 排序类型
                  description: "This is List Type  \n查询排序集合"
                where:
                  type: object
                  properties:
                    activitiesName:
                      type: string
                      description: 相关活动关键字
                    atlasStatus:
                      type: integer
                      format: int32
                      description: 图谱状态，-1为删除，0为入库，1为上架或者发布，2为下架，不传则查询全部
                    begCreateDate:
                      type: string
                      description: 创建时间开始
                    begDelDate:
                      type: string
                      description: 删除时间开始
                    begSchemeSized:
                      type: number
                      format: double
                      description: 面积开始
                    begStatusDate:
                      type: string
                      description: 状态时间开始
                    categorys:
                      type: object
                      description: 类目数组
                    endCreateDate:
                      type: string
                      description: 创建时间结束
                    endDelDate:
                      type: string
                      description: 

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