Mock 测试数据生成

接口标识: mockdata 价格: 0.008 元/次同步响应

接口介绍
接口文档
在线测试

接口简介

Mock 测试数据生成接口按类型批量产出中文仿真测试数据，涵盖姓名、手机号、身份证、银行卡、地址、邮箱、公司名、UUID、ISO8601 时间与文本十种类型，可任意组合，单次最多 1000 条。身份证与银行卡为校验位合法的虚构号码，与任何真实公民信息无关，可通过表单与规则校验；传入随机种子即可精确复现同一批数据，便于回归比对。适合系统联调造数、演示环境填充、自动化测试与教学练习等场景。

详细介绍

![Mock 测试数据生成接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261111/apiops_mockdata__1794363325_0d980bf1ae60.png)

联调要造数、演示要造数、压测还要造数，手工编数据费时还容易踩合规红线。Mock 测试数据生成接口一键批量产出中文仿真数据。

## 接口概述
面向系统联调造数、演示环境填充与自动化回归测试等场景，勾选所需的数据类型并指定条数，接口同步返回结构化的中文测试数据。类型涵盖姓名、手机号、身份证号、银行卡号、地址、邮箱、公司名、UUID、ISO8601 时间与文本共十种，可任意组合。身份证与银行卡为校验位合法的虚构号码，与任何真实公民信息无关，可放心入库与展示；传入随机种子可精确复现同一批数据，便于回归测试前后比对。

## 核心能力
1. **十种类型**：姓名、手机号、身份证、银行卡、地址、邮箱、公司名、UUID、时间、文本，多类型逗号组合一次生成。
2. **批量产出**：单次最多 1000 条，造满一张业务表只需一次调用。
3. **号码合规**：身份证与银行卡为校验位合法的虚构号码，能通过表单与规则引擎的格式校验。
4. **种子复现**：传入相同随机种子输出完全相同的一批数据，回归比对无忧。
5. **中文语境**：姓名、地址、公司名均按中文习惯生成，演示数据真实自然。

## 产品优势
1. **接入简单**：单次 POST 传类型与条数即得数据，无需编写造数脚本。
2. **响应迅速**：本地同步生成，千条级数据秒内返回。
3. **合规安心**：全部数据为虚构生成，规避使用真实个人信息的合规风险。
4. **稳定可靠**：无外部依赖，造数结果格式稳定可预期。
5. **降本增效**：替代手工编造 Excel 测试数据，即改即用不重复劳动。

## 效果展示
一句话理解：它就像测试环境的「道具工厂」，你报出清单和数量，它就造出一批以假乱真、专供测试的道具数据。

以一次真实调用为例，你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| type | name,phone,idcard | 要生成的数据类型，多个用英文逗号分隔，共十种可选 |
| count | 2 | 生成条数，1~1000，默认 1 |
| seed | 42 | 随机种子，可选；同一种子可复现同一批数据 |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 所选类型 | ["name","phone","idcard"] | `types`，回显本次生成的类型清单 |
| 生成条数 | 2 | `count` |
| 姓名 | 张伟 / 李娜 | `data[].name`，中文姓名 |
| 手机号 | 15912345678 / 13787654321 | `data[].phone`，虚构号码 |
| 身份证号 | 110101199003077213 / 31010119851122442X | `data[].idcard`，校验位合法的虚构号码 |

API请求示例：

```text
POST /api/mockdata
type=name,phone,idcard&count=2&seed=42
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "types": ["name", "phone", "idcard"],
    "count": 2,
    "data": [
      {"name": "张伟", "phone": "15912345678", "idcard": "110101199003077213"},
      {"name": "李娜", "phone": "13787654321", "idcard": "31010119851122442X"}
    ]
  },
  "request_id": "mock-demo-seed42-0001"
}
```

示例中的姓名、手机号与身份证号均为虚构值，身份证号校验位合法、可直接进规则引擎测试；再次以 seed=42 调用，得到的仍是这两条数据。

## 应用场景
1. **联调造数**：前后端联调前批量生成业务表测试记录，告别手填。
2. **演示环境**：为演示与验收环境快速填充贴近真实的中文数据。
3. **自动化测试**：固定随机种子构建可复现的回归数据集，比对测试结果。
4. **校验逻辑验证**：用校验位合法的虚构号码测试表单校验与风控规则。
5. **教学培训**：数据库与开发课程生成练习用样例数据，不涉真实信息。

## 应用案例
一家电商 SaaS 团队每次联调都要开发手工编几百条测试订单，假手机号还常被校验规则拦下；改用接口批量生成姓名、手机号与地址后，造数时间从半天缩到几分钟。

一家金融科技公司的风控规则引擎需要针对身份证校验逻辑做边界测试，出于合规不能动用真实用户数据；用接口生成校验位合法的虚构身份证，既覆盖测试用例又通过了内部审计。

一家培训机构的数据库课程需要为每期学员准备一套全新的学员名单做练习数据；讲师固定种子生成班级名单，学员答案可互相核对、可复现，批改效率明显提升。

常见问题

Q：生成的身份证号是真实的吗？

A：不是。所有号码均为算法虚构生成，与任何真实公民信息无关；但校验位符合国家标准算法，能正常通过表单格式校验与规则引擎测试，可放心用于开发与测试环境。

Q：如何让两次生成的数据完全一致？

A：传入相同的 seed（整数随机种子）即可。同一种子、同一类型与条数组合，输出的数据完全相同，适合自动化回归测试前后比对。

Q：一次最多能生成多少条？

A：单次请求 count 最大为 1000，超出范围会返回参数错误（code=40002）。需要更大数据量时分多次调用即可。

测试数据造数 Mock 模拟数据随机数据假数据生成

接口地址： https://www.phpwc.cn/api/mockdata

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`type`	string	必填	-	数据类型：name/phone/idcard/bankcard/address/email/company/uuid/datetime/text，多个用逗号分隔
`count`	int	选填	`1`	生成条数，1-1000，默认 1
`seed`	int	选填	-	随机种子，同种子结果可复现

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`types`	array	所选数据类型列表
`count`	int	生成条数
`data`−	array	数据数组，每项含所选类型字段
`name`	string	姓名
`phone`	string	手机号
`idcard`	string	身份证（校验位合法的虚构号）
`bankcard`	string	银行卡号
`address`	string	地址
`email`	string	邮箱
`company`	string	公司名
`uuid`	string	UUID
`datetime`	string	ISO8601 时间
`text`	string	一段文本
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试