Dữ liệu giả tiếng Việt API
Dữ liệu test tiếng Việt như thật: họ tên, địa chỉ theo bản đồ hành chính 2025, số di động theo nhà mạng, CCCD và MST đúng cấu trúc, công ty, tài khoản ngân hàng.
API dữ liệu giả sinh các bản ghi tiếng Việt giống thật để kiểm thử, demo và nạp dữ liệu mẫu: họ tên đầy đủ tách thành họ, tên đệm, tên (họ được chọn theo tỉ lệ thực tế, tên đệm hợp giới tính), ngày sinh, email, số di động với đầu số thật của Viettel, Vinaphone, MobiFone, Vietnamobile, Gmobile, và địa chỉ gồm tên đường cùng phường / xã, tỉnh thật theo bản đồ hành chính 2025, kèm mã bưu chính.
fields=all thêm số CCCD khớp với người được tạo (mã tỉnh, mã thế kỷ và giới tính, năm sinh), mã số thuế 10 số có chữ số kiểm tra đúng, công ty, nghề nghiệp, tài khoản ở ngân hàng thật với tên chủ tài khoản viết hoa, username và UUID. Tối đa 1.000 bản ghi mỗi lần; format=csv trả về file CSV. Cùng một seed luôn cho cùng dữ liệu, giúp test lặp lại được.
Không có dữ liệu nào lấy từ người thật. Email dùng các tên miền dành riêng example.com / .net / .org; CCCD và MST chỉ đúng cấu trúc và được ghi rõ là dữ liệu giả. Không dùng chúng như giấy tờ thật.
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
count | body|query | number | không | 10 | Số bản ghi (1–1000). |
fields | body|query | string | không | name,gender,birthday,email,phone,address | Danh sách phân cách bằng dấu phẩy: name, gender, birthday, email, phone, address, cccd, tax_code, company, job, bank_account, username, uuid, hoặc all. |
seed | body|query | string | không | Seed để sinh lại đúng dữ liệu. | |
gender | body|query | string | không | any | any, male hoặc female. |
min_age | body|query | number | không | 18 | Tuổi tối thiểu. |
max_age | body|query | number | không | 65 | Tuổi tối đa. |
format | body|query | string | không | json | json hoặc csv. |
Ví dụ
curl "https://apibox.io.vn/v1/fake-data?count=1&seed=abc" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch('https://apibox.io.vn/v1/fake-data?count=1&seed=abc', {
method: 'GET',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
},
});
const data = await res.json();
console.log(data);import requests
res = requests.get(
"https://apibox.io.vn/v1/fake-data?count=1&seed=abc",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/fake-data?count=1&seed=abc');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));Kết quả trả về
{
"seed": "abc",
"count": 1,
"fields": [
"name",
"gender",
"birthday",
"email",
"phone",
"address"
],
"note": "Fake data for testing. Emails use reserved example domains; CCCD and tax codes only have a valid structure and must not be used as real documents.",
"data": [
{
"name": "Nguyễn Minh Hà",
"family_name": "Nguyễn",
"middle_name": "Minh",
"given_name": "Hà",
"gender": "female",
"birthday": "2003-12-18",
"age": 23,
"email": "ha.nguyen26@example.com",
"phone": "0923091759",
"phone_e164": "+84923091759",
"carrier": "Vietnamobile",
"address": {
"street": "269/30 Nguyễn Thị Minh Khai",
"ward": "Xã Tân Đông",
"ward_code": "25522",
"province": "Tỉnh Tây Ninh",
"province_code": "80",
"postal_code": "80311",
"full": "269/30 Nguyễn Thị Minh Khai, Xã Tân Đông, Tỉnh Tây Ninh"
}
}
]
}
Ứng dụng
- Nạp dữ liệu mẫu tiếng Việt cho môi trường staging
- Demo giao diện, chụp màn hình không cần dữ liệu khách hàng thật
- Kiểm thử validate họ tên, SĐT, địa chỉ, giấy tờ
- Load test với bộ dữ liệu lặp lại được (seed)
Hỏi đáp
Số CCCD có phải số thật không?
Đó là số ngẫu nhiên đúng cấu trúc (qua được kiểm tra của vn-id) và khớp với người được tạo. Không tra cứu ở đâu cả; một số ngẫu nhiên có thể tình cờ trùng số thật, nên không bao giờ coi chúng là giấy tờ thật.
Có lấy lại đúng dữ liệu cũ được không?
Được: truyền cùng seed, count và fields. Không có seed thì API tự tạo và trả về seed trong phản hồi.
Địa chỉ có thật không?
Phường xã, tỉnh và mã bưu chính là thật (sau sáp nhập 2025); tên đường là các tên phổ biến và số nhà ngẫu nhiên, nên tổ hợp thường không phải địa chỉ có thật.
API liên quan
Webhook Tester
Tạo một URL riêng ghi lại mọi request HTTP gửi tới nó – method, header, query, body – rồi xem trực tiếp trên trình duyệt hoặc qua API.
{?}Dữ liệu mẫu từ JSON Schema
Sinh JSON mẫu như thật từ JSON Schema (kiểu, format, enum, pattern, khoảng giá trị, $ref, oneOf / allOf), có kiểm tra lại theo schema.
◧So sánh hai ảnh
So sánh hai ảnh theo từng điểm ảnh (khoảng cách màu theo cảm nhận, bỏ qua khử răng cưa) và cho biết tỷ lệ điểm ảnh thay đổi, vùng thay đổi và ảnh khác biệt được tô màu.