{"id":21909770,"url":"https://github.com/jimmylibs/mockapi","last_synced_at":"2025-04-16T02:12:24.494Z","repository":{"id":138062736,"uuid":"168279924","full_name":"JimMyLibs/mockApi","owner":"JimMyLibs","description":"做符合中国人使用习惯的mock，随取随用，用完即走。","archived":false,"fork":false,"pushed_at":"2019-09-18T07:32:22.000Z","size":81,"stargazers_count":10,"open_issues_count":4,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-16T02:12:04.770Z","etag":null,"topics":["json","json-api","mock","mockjs","nodejs"],"latest_commit_sha":null,"homepage":"http://mock.91525.net","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JimMyLibs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-01-30T04:35:34.000Z","updated_at":"2023-02-01T09:18:16.000Z","dependencies_parsed_at":null,"dependency_job_id":"d7e9f5ac-a5e5-4d33-8225-a3ca784b175c","html_url":"https://github.com/JimMyLibs/mockApi","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JimMyLibs%2FmockApi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JimMyLibs%2FmockApi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JimMyLibs%2FmockApi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JimMyLibs%2FmockApi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JimMyLibs","download_url":"https://codeload.github.com/JimMyLibs/mockApi/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249183106,"owners_count":21226142,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["json","json-api","mock","mockjs","nodejs"],"created_at":"2024-11-28T17:26:01.080Z","updated_at":"2025-04-16T02:12:24.486Z","avatar_url":"https://github.com/JimMyLibs.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mockApi\nmock模拟数据接口\n\n\u003e ### [在线体验: demo](http://mock.91525.net)\n\u003e ### [客户端](https://github.com/JimMyLibs/mockapi-vueTs)\n\u003e ### [服务端](https://github.com/JimMyLibs/mockApi)\n\n\u003e [我要用的字段，你这里面没有！我有新字段需求要提交](https://github.com/JimMyLibs/mockApi/issues/4)\n\n![demo截图](https://raw.githubusercontent.com/JimMyLibs/mockapi-vueTs/master/src/resource/screenshot/mockapi-vueTs001.gif)\n\n### 使用方法\n```\ngit clone https://github.com/JimMyLibs/mockApi.git\ncd mockApi\nnpm install\n// 启动项目\nnode index.js\n```\n\u003e 如果想快速调试，请安装nodemon\n```\nnpm install -g nodemon\nnpm install --save-dev nodemon\n// 启动项目\nnodemon\n```\n---\n\n## 使用规则\n\u003e 默认选择作者jim名下的req_res模拟规则，详情查看[具体规则](https://github.com/JimMyLibs/mockApi/tree/master/app/rules/jim/req_res)\n\n### 1. 使用规则一：投桃报李\n```\n// 作者: jim  规则: req_res\n// 使用方法: 将返回字段及其格式，以请求参数的形式发送给接口\nfetch('http://mock.91525.net:3001/**/**',{\n\tmock:{\n\t\tid: 'id',\n\t\tname: 'cname'\n\t}\n})\n// 响应信息\n{\n    \"ret\": \"10000\",\n    \"message\": \"模拟数据\",\n    \"data\": {\n        \"id\": \"360000201401253686\",\n        \"name\": \"马云\",\n    }\n}\n```\n---\n## 目前已支持字段\n\n### 新增功能-20190829\n```\n// 支持生成随机字数的中英文字符串\n\"cnStr[100]: 生成100个以内随机个数的中文字符\n\"enStr[100]: 生成100个以内随机个数的英文字符\n```\n\n### 新增功能-20190829\n```\n支持自定义codeNames，包含：['code','resCode','result','errCode','ErrCode'];\n支持自定义msgNames，包含：['message','msg','errMsg','ErrMsg'];\n```\n![支持自定义codeNames\u0026\u0026msgNames](https://raw.githubusercontent.com/JimMyLibs/mockApi/master/public/img/20190829-codeName001.png)\n\n### 新增功能-20190827\n```\npagesize支持随机条数\n```\n\n### 新增字段-20190328\n```\n\"1-10\": 3, //  min-max之间随机正整数\n\"1.123-99.123456\": 36.8284, // min-max之间随机正浮点数\n\"[1,12,123,1234]\": 123, // 多中取一\n```\n\n### 常用字段\n```\n\"id\": \"320000200904181643\", // ID\n\"cname\": \"贺明\", // 姓名\n\"username\": \"jim001\", // 用户名\n\"tel\": \"0595-20679780\", // 固话号码\n\"phone\": \"18921558010\", // 手机号码\n\"idCard\": \"617512200803104130\", // 身份证号码\n\"bankCard\": \"6226092484148081\", // 银行卡号码\n\"email\": \"towq456@iruihm.com\", // 邮箱地址\n\"qq\": \"55568995102\", // QQ号\n\"carNum\": \"桂ZM4KNP警\", // 车牌号\n\"icon\": \"http://dummyimage.com/64x64\", // 图标\n\"detailAddress\": \"北京 北京市 海淀区 铁新里路58号\" // 详细地址\n\n```\n### 分页字段\n```\n\"pageSize\": 10, // 每页条数\n\"totalNum\": 23, // 总条数\n\"curPage\": 3， // 当前页码\n\n```\n### 自定义分页字段\n```\n\"pageSize\": { pageSizeName: 10 }, // pageSizeName: 每页条数字段\n\"totalNum\": { totalNumName: 23 }, // totalNumName: 总条数字段\n\"curPage\": { curPageName: 3 }, // curPageName: 当前页码字段\n\n```\n\n### Mockjs原生字段\n\n#### Basic：基础数据类型\n```\n\"boolean\": 布尔型\n\"natural\": 自然数[16位随机数]\n\"integer\": 整数[16位随机数]\n\"float\": 浮点型\n\"character\": 字母\n\"string\": 随机字符串\n\"range\": 数字范围\n```\n#### Date：日期\n```\n\"date\": 日期('yyyy-MM-dd')\n\"time\": 时间('HH:mm:ss')[24小时]\n\"datetime\": 日期时间('yyyy-MM-dd HH:mm:ss')\n\"now\": 当前时间('yyyy-MM-dd HH:mm:ss')\n```\n#### Image：图片\n```\n\"image\": 图片\n\"dataImage\": base64\n```\n#### Color：颜色\n```\n\"color\":\n\"hex\":\n\"rgb\":\n\"rgba\":\n\"hsl\":\n```\n#### Text：文本\n```\n\"paragraph\":\n\"sentence\":\n\"word\":\n\"title\":\n\"cparagraph\":\n\"csentence\":\n\"cword\":\n\"ctitle\":\n```\n#### Name：名称\n```\n\"first\": 名\n\"last\": 姓\n\"name\": 姓名\n\"cfirst\":\n\"clast\":\n\"cname\":\n```\n#### Web：网络\n```\n\"url\":\n\"domain\":\n\"protocol\": URL 的协议\n\"tld\": 域名后缀\n\"email\":\n\"ip\":\n```\n#### Address：地址\n```\n\"region\": 地区\n\"province\": 省\n\"city\":\n\"county\": 县\n\"zip\": 邮政编码\n```\n#### Helper：转换助手(参数必填)\n```\n\"capitalize\": 首字母大写\n\"upper\": 大写\n\"lower\": 小写\n\"pick\": 挑选\n\"shuffle\": 洗牌\n```\n#### Miscellaneous：其他\n```\n\"guid\":\n\"id\":\n\"increment\": 递增\n```\n\n\n\n\n---\n\n### 2. 使用规则二：自给自足\n\n\u003e 根据请求参数，选择某个作者及其名下的模拟规则，详情查看[具体规则](https://github.com/JimMyLibs/mockApi/tree/master/app/rules/jim/url_fn)\n```\n// 作者: jim  规则: req_res\n// 使用方法: 将返回字段及其格式，以请求参数的形式发送给接口\nfetch('http://mock.91525.net:3001/index/all',{\n\t\"mock\":{\n\t\t\"auth\":\"jim\",\n\t\t\"rule\":\"url_fn\"\n\t}\n})\n// 响应信息\n{\n    \"ret\": \"10000\",\n    \"message\": \"模拟数据\",\n    \"data\": {\n        // 自己配置\n    }\n}\n```\n---\n\n## 目录结构\n```\n├── app/        // 业务代码\n│   ├── index.js        // 接口配置\n│   └── rules/      // 规则目录\n│       ├── index.js        // 规则入口\n│       └── jim/        // 某规则负责人目录\n│           ├── index.js        // 该规则包入口\n│           ├── url_fn/     // 单条规则目录\n│           │   ├── index.js        // 该条规则入口\n│           │   └── rule.js     // 该条规则内容\n│           └── utils/      // 该规则包的工具包\n│               ├── api.js      // Mockjs Api一览表\n│               └── index.js        // 工具包内容\n├── index.js        // 程序入口lj\n├── LICENSE     // 开原协议\n├── node_modules/       // 依赖包\n├── package.json        // 依赖包\n└── README.md       // 说明文件\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjimmylibs%2Fmockapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjimmylibs%2Fmockapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjimmylibs%2Fmockapi/lists"}