创建数据模型

提示

在数据模型、接口入参定义或接口响应期望定义中，会经常使用到数据结构来可视化定义jsonschema，以便用来设计接口

创建数据模型

新建模型入口

提示

模型名称：必填，且必须是唯一的，常为字母、数字、下划线构成
别名：一般为中文名，方便查找和查看
目录：可以将模型分类管理
备注：用于备注说明描述模型的作用

编辑数据模型

智能导入

如果已经有现成的结构文件，可以通过智能导入的方式，快速生成jsonschema的结构，避免了手动输入的繁琐，目前支持json、xml、jsonschema、mysql ddl 格式的智能导入

Json示例

{
    "userInfo_get_response":{
        "result":{
            "model":{
                "open_id":"qwertyuiuduiasd",
                "avatar":"avatar url",
                "nick":"snsNick"
            },
            "err_message":"err_message",
            "err_code":"err_code",
            "success":false
        }
    }
}

Xml示例

**<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>**

Jsonschema示例

{  
  "$schema": "http://json-schema.org/draft-07/schema#",  
  "title": "Person Schema",  
  "type": "object",  
  "properties": {  
    "name": {  
      "type": "string",  
      "description": "The name of the person.",  
      "minLength": 2  
    },  
    "age": {  
      "description": "Age in years which must be equal to or greater than zero.",  
      "type": "integer",  
      "minimum": 0  
    },  
    "email": {  
      "type": "string",  
      "description": "The email address of the person.",  
      "format": "email"  
    }  
  },  
  "required": ["name", "age", "email"]  
}

Mysql DDL示例

CREATE TABLE orders (  
    order_id INT AUTO_INCREMENT PRIMARY KEY,  
    customer_id INT NOT NULL,  
    order_date DATE NOT NULL,  
    total_amount DECIMAL(10, 2) NOT NULL,  
    status VARCHAR(50) NOT NULL,  
    FOREIGN KEY (customer_id) REFERENCES customers(customer_id)  
);