Tạo UUID API
Sinh tối đa 1.000 UUID v4, UUID v7 theo thời gian, ULID, Nano ID hoặc mã hex ngẫu nhiên mỗi request. Ngẫu nhiên an toàn, hỗ trợ chữ in hoa.
API UUID sinh mã định danh duy nhất theo các định dạng mà ứng dụng hiện đại hay dùng. type=v4 (mặc định) trả về UUID ngẫu nhiên chuẩn RFC 4122, v7 trả về UUID sắp xếp theo thời gian với 48 bit đầu là timestamp mili giây (rất hợp làm khoá chính database vì tự sắp theo thời điểm tạo), ulid trả về ULID 26 ký tự base32 Crockford, nanoid trả về Nano ID an toàn cho URL, còn hex trả về chuỗi hex ngẫu nhiên.
Dùng count để lấy từ 1 đến 1.000 mã trong một lần gọi, size (4–64, mặc định 21) để chọn độ dài Nano ID và mã hex, và uppercase=true để xuất chữ in hoa. Mọi giá trị đều lấy từ bộ sinh số ngẫu nhiên an toàn mật mã.
Phản hồi là một JSON nhỏ gồm loại mã, số lượng và mảng ids – dễ dùng trong script, seeder hay job CI cần mã định danh mới.
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
type | query | string | không | v4 | v4, v7, ulid, nanoid hoặc hex. |
count | query | number | không | 1 | Số mã cần tạo, 1–1000. |
size | query | number | không | 21 | Độ dài mã nanoid và hex, 4–64. |
uppercase | query | boolean | không | false | Trả về mã viết hoa. |
Ví dụ
curl "https://apibox.io.vn/v1/uuid?type=v7&count=2" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch('https://apibox.io.vn/v1/uuid?type=v7&count=2', {
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/uuid?type=v7&count=2",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/uuid?type=v7&count=2');
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ề
{
"type": "v7",
"count": 2,
"ids": [
"01a1c3db-75cb-79dc-9577-3e0e9b396b1c",
"01a1c3db-75cb-7239-a4a1-a944d53b7c02"
]
}Ứng dụng
- Sinh khoá chính hoặc idempotency key ngoài database
- Tạo dữ liệu mẫu, fixture với mã định danh thực tế
- Dùng UUID v7 / ULID sắp xếp được cho log sự kiện
- Lấy Nano ID ngắn, an toàn cho URL làm mã mời, link chia sẻ
Hỏi đáp
Nên dùng UUID v4 hay UUID v7?
v4 hoàn toàn ngẫu nhiên. v7 bắt đầu bằng timestamp nên mã mới luôn đứng sau mã cũ; điều này giữ index B-tree gọn và khiến v7 phù hợp hơn làm khoá chính database.
Tạo được bao nhiêu UUID một lần?
Tối đa 1.000 mã mỗi request với count=1000. Mỗi request chỉ tính là một lượt gọi trong quota.
ULID và UUID v7 khác nhau thế nào?
Cả hai đều 128 bit và sắp xếp theo thời gian. ULID viết bằng 26 ký tự base32 (ví dụ 01J...), còn UUID v7 dùng định dạng UUID chuẩn 36 ký tự có gạch nối mà database hỗ trợ sẵn kiểu dữ liệu.
API liên quan
Phân tích biểu thức cron
Kiểm tra biểu thức cron và xem các lần chạy tiếp theo theo múi giờ bất kỳ, kèm mô tả dễ hiểu. Hỗ trợ cú pháp cron 5, 6 và 7 trường.
🕒Giờ & múi giờ
Lấy giờ hiện tại ở mọi múi giờ, đổi giữa các múi giờ và Unix timestamp (giây hoặc mili giây), kèm độ lệch UTC và thứ trong tuần cho tối đa 30 múi giờ.
🎨Chuyển đổi màu
Đổi mã màu giữa HEX, RGB, HSL, CMYK, kiểm tra độ tương phản WCAG và lấy màu bổ sung, bộ ba, tương đồng cùng các sắc độ chỉ trong một lần gọi.