测试数据生成
正常 NEW开发/测试用随机数据生成器: UUID v4、随机密码/字符串、中文姓名、手机号 (真实在用号段)、测试银行卡号 (Luhn 合法)、邮箱、公网 IPv4、MAC 地址。全部使用 CSPRNG (random_bytes/random_int)。零外部请求、零数据落库。
¥
0.002
/ 次
按次计费
健康检查 。
健康检查 。
调用方式：在接口地址后拼接
?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。
GET
http://www.shujuyu.cn/v1/api/mock/ping
JSON
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 您的API密钥，可在个人中心获取 |
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | - |
| msg | string | - |
| data | object | - |
| data.version | string | - |
| data.time | string | - |
请求示例
返回示例
{"msg":"pong","code":0,"data":{"time":"2026-11-03 00:53:44","version":"1.0"}}
类型清单 。
类型清单 。
调用方式：在接口地址后拼接
?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。
GET
http://www.shujuyu.cn/v1/api/mock/types
JSON
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 您的API密钥，可在个人中心获取 |
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | - |
| msg | string | - |
| data | object | - |
| data.total | int | - |
| data.note | string | - |
| data.list | array | - |
请求示例
返回示例
{"msg":"success","code":0,"data":{"list":[{"type":"uuid","description":"UUID v4"},{"type":"mobile","description":"随机手机号 (真实在用号段)"}],"note":"...","total":9}}
按类型批量生成。Body: {"types": ["uuid", "name",
按类型批量生成。Body: {"types": ["uuid", "name", "mobile", "bankcard"], "count": 3}
调用方式：在接口地址后拼接
?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。
POST
http://www.shujuyu.cn/v1/api/mock/generate
JSON
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 您的API密钥，可在个人中心获取 |
| types | array | 是 | - |
| count | int | 是 | - |
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | - |
| msg | string | - |
| data | object | - |
| data.count | int | - |
| data.data | object | - |
请求示例
返回示例
{"msg":"success","code":0,"data":{"data":{"mac":["C4:B9:9B:12:91:EF","...","..."],"ipv4":["45.232.166.190","...","..."],"name":["于瑶春","蔡栋鹏","谭红沛"],"uuid":["eb053749-f61a-408b-935c-05318615c9a1","...","..."],"email":["wovo98@126.com","...","..."],"mobile":["18779276719","...","..."],"bankcard":["6225881291824620","...","..."]},"count":3}}
产品说明
产品概述
开发/测试用随机数据生成器: UUID v4、随机密码/字符串、中文姓名、手机号 (真实在用号段)、测试银行卡号 (Luhn 合法)、邮箱、公网 IPv4、MAC 地址。全部使用 CSPRNG (random_bytes/random_int)。零外部请求、零数据落库。
使用场景
数据查询：快速集成 测试数据生成 到您的应用中
业务系统：将 测试数据生成 数据嵌入业务流程
开发工具：通过 API 接口获取 开发工具 数据
数据分析：基于 测试数据生成 数据进行分析和决策
费用计算
按次计费单价
¥0.002
/ 次
每次调用接口从账户余额中扣除相应费用，VIP 用户可享折扣
扣费优先级
免费额度
次数包
余额扣费
计费方式详解
1
免费额度
· 接口每日免费额度已关闭
· VIP 用户月度免费额度：
· 个人版：每月 5000 次，本接口月上限 5000 次
· 专业版：每月 30000 次，本接口月上限 30000 次
· 企业版：每月 200000 次，本接口月上限 200000 次
· 账户如有注册/活动赠送的免费次数，会优先于接口免费额度扣减
· VIP 月度免费额度仅适用于单次售价不高于 ¥0.0800/次 的接口；接口每日免费额度按接口配置执行
VIP 月度免费额度每月重置，未使用部分不累计至下月。
· VIP 用户月度免费额度：
· 个人版：每月 5000 次，本接口月上限 5000 次
· 专业版：每月 30000 次，本接口月上限 30000 次
· 企业版：每月 200000 次，本接口月上限 200000 次
· 账户如有注册/活动赠送的免费次数，会优先于接口免费额度扣减
· VIP 月度免费额度仅适用于单次售价不高于 ¥0.0800/次 的接口；接口每日免费额度按接口配置执行
VIP 月度免费额度每月重置，未使用部分不累计至下月。
2
次数包
预付费购买固定调用次数，折算单价与按次付费相同，用完为止。
次数包为独立计费，不与 VIP 折扣叠加。
请在有效期内使用，过期后未使用的次数不可再用。
次数包为独立计费，不与 VIP 折扣叠加。
请在有效期内使用，过期后未使用的次数不可再用。
3
余额扣费
按次从账户余额扣除费用；所有用户可享量折扣，VIP 用户额外享 VIP 折扣。
扣费公式：实际扣费 = 接口单价 × (1 - VIP 折扣比例 - 量折扣比例)，并受总折扣上限和最低利润率保护约束
VIP 折扣： 个人版9折 专业版8折 企业版7折
量折扣： 月付费调用 ≥1000 次享 2%、 月付费调用 ≥10000 次享 5%、 月付费调用 ≥20000 次享 10%
· 量折扣按账号当月全部接口的付费调用次数统计，达到更高档位时按更高档位计算
总折扣上限：VIP 折扣 + 量折扣合计不超过 50%
最低利润率保护：折后价不得低于成本价 × (1 + 15%)；若接口售价本身低于该保护价，则取消折扣并按售价计费
余额不足时调用将失败，请及时充值。
扣费公式：实际扣费 = 接口单价 × (1 - VIP 折扣比例 - 量折扣比例)，并受总折扣上限和最低利润率保护约束
VIP 折扣： 个人版9折 专业版8折 企业版7折
量折扣： 月付费调用 ≥1000 次享 2%、 月付费调用 ≥10000 次享 5%、 月付费调用 ≥20000 次享 10%
· 量折扣按账号当月全部接口的付费调用次数统计，达到更高档位时按更高档位计算
总折扣上限：VIP 折扣 + 量折扣合计不超过 50%
最低利润率保护：折后价不得低于成本价 × (1 + 15%)；若接口售价本身低于该保护价，则取消折扣并按售价计费
余额不足时调用将失败，请及时充值。
VIP 权益对比
| 等级 | 每月免费次数 | 本接口月免费上限 | 折扣 | VIP 折后单价 |
|---|---|---|---|---|
| 免费版 | 按接口配置 | — | - | ¥0.002/次 |
| 个人版 | 5000 次 | 5000 次 | 10% | ¥0.0018/次 |
| 专业版 | 30000 次 | 30000 次 | 20% | ¥0.0016/次 |
| 企业版推荐 | 200000 次 | 200000 次 | 30% | ¥0.0014/次 |
* VIP 月度免费额度每月重置。每月免费次数为账号级 VIP 月额度，本接口月免费上限为其中对本接口的限制（接口可单独设置上限或关闭）。VIP 折扣仅适用于余额扣费方式，VIP 折后单价不含量折扣。
本接口已关闭接口级月度免费额度（不影响 VIP 月度免费额度）。接口每日免费额度已关闭。
费用计算示例
* 以下示例未包含量折扣，量折扣按账号当月全部接口的付费调用量另行计算。
示例1：普通用户按次付费
调用 1000 次，费用 = 0.002 × 1000 = ¥2.00
示例2：个人版用户按次付费（仅 VIP 折扣，已考虑最低利润率保护）
调用 1000 次，折扣约 10%，费用 = 0.002 × (1 - 10%) × 1000 ≈ ¥1.80
错误码说明
本接口未定义专属错误码，调用时请参考通用错误码体系。
查看通用错误码参考
| 错误码 | 说明 | 解决方案 |
|---|---|---|
| 200 | 请求成功 | - |
| 400000 | 请求参数错误 | 检查参数名、格式与取值 |
| 401000 | 认证失败 | 检查 Authorization: Bearer 密钥是否正确、是否过期 |
| 401002 | 缺少 API 认证参数 | 请求未携带 key，请通过 URL 参数 key 或请求头 Authorization 传递密钥 |
| 402000 | 账户余额不足 | 充值后重试 |
| 403000 | 无访问权限 | 确认密钥权限、接口范围与 IP 白名单是否满足要求 |
| 404001 | 接口或端点不存在 | 检查 API 与端点的请求路径 |
| 409000 | 请求冲突 | 请稍后重试 |
| 422000 | 参数校验失败 | 检查参数格式与取值 |
| 429001 | 请求频率超限（QPS） | 降低请求频率，或升级套餐提升额度 |
| 429002 | 分钟级调用频率超限 | 降低调用频率，或升级套餐提升额度 |
| 429003 | 小时级调用额度已用完 | 升级套餐提升额度，或整点后重试 |
| 429004 | 今日调用额度已用完 | 升级套餐提升额度，或次日重试 |
| 500000 | 服务器内部错误 | 携带响应中的 request_id 联系技术支持 |
| 502000 | 服务暂时不可用 | 稍后重试 |
| 503000 | 服务暂时不可用 | 稍后重试 |
| 504000 | 请求超时 | 稍后重试 |
更新日志
暂无更新日志