Tạo slug API
Chuyển tiêu đề thành slug URL gọn gàng: bỏ dấu tiếng Việt (cả chữ đ), tuỳ chọn ký tự phân cách, giữ chữ hoa và giới hạn độ dài.
Gửi text (qua query string, trường JSON hoặc form, hoặc body văn bản thô) và nhận về slug an toàn cho URL. Dấu thanh và dấu phụ bị loại bỏ (Việt Nam thành viet-nam, đ thành d), các chữ đặc biệt như ß, æ, ø, ł được chuyển tự, dấu nháy bị bỏ và mỗi cụm ký tự không phải chữ hoặc số được thay bằng một ký tự phân cách.
Tuỳ chọn: separator có thể là - (mặc định), _, . hoặc chuỗi rỗng; lowercase=false để giữ nguyên chữ hoa; max_length (1-1000) cắt slug và bỏ ký tự phân cách thừa ở cuối.
Văn bản đầu vào tối đa 10.000 ký tự.
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
text | body|query | string | có | Văn bản cần tạo slug (tối đa 10.000 ký tự). Có thể gửi dạng body văn bản thô. | |
separator | body|query | string | không | - | Ký tự phân cách: -, _, . hoặc rỗng. Giá trị khác sẽ dùng -. |
lowercase | body|query | boolean | không | true | Chuyển thành chữ thường; false để giữ nguyên chữ hoa. |
max_length | body|query | number | không | Độ dài tối đa của slug (1-1000). Không giới hạn nếu bỏ trống. |
Ví dụ
curl "https://apibox.io.vn/v1/slugify?text=Xin%20ch%C3%A0o%20Vi%E1%BB%87t%20Nam!%20%C4%90%C3%A2y%20l%C3%A0%20APIBox" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch('https://apibox.io.vn/v1/slugify?text=Xin%20ch%C3%A0o%20Vi%E1%BB%87t%20Nam!%20%C4%90%C3%A2y%20l%C3%A0%20APIBox', {
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/slugify?text=Xin%20ch%C3%A0o%20Vi%E1%BB%87t%20Nam!%20%C4%90%C3%A2y%20l%C3%A0%20APIBox",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/slugify?text=Xin%20ch%C3%A0o%20Vi%E1%BB%87t%20Nam!%20%C4%90%C3%A2y%20l%C3%A0%20APIBox');
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ề
{
"slug": "xin-chao-viet-nam-day-la-apibox"
}
Ứng dụng
- Tạo đường dẫn tĩnh cho bài viết blog, trang sản phẩm
- Tạo tên file hoặc mã định danh từ tiêu đề người dùng nhập
- Tạo URL chuẩn SEO cho nội dung tiếng Việt
- Chuẩn hoá tên tag và danh mục
Hỏi đáp
Có xử lý được tiếng Việt có dấu không?
Có. Mọi dấu thanh bị loại bỏ và đ/Đ thành d/D, ví dụ "Xin chào Việt Nam" thành xin-chao-viet-nam.
Có dùng dấu gạch dưới thay cho gạch ngang được không?
Được, đặt separator=_. Các giá trị hợp lệ là -, _, . và chuỗi rỗng.
Làm sao giới hạn độ dài slug?
Dùng max_length, ví dụ max_length=60. Ký tự phân cách còn sót ở cuối sau khi cắt sẽ bị bỏ.
API liên quan
So sánh văn bản
So sánh hai đoạn văn bản theo dòng, từ, ký tự, câu hoặc JSON; nhận danh sách thay đổi, tỉ lệ giống nhau và bản diff dạng unified.
123Thống kê văn bản
Đếm số từ, ký tự, câu, đoạn và dòng; ước tính thời gian đọc và thời gian nói; liệt kê các từ xuất hiện nhiều nhất trong văn bản.
AaĐổi kiểu chữ
Chuyển văn bản sang chữ thường, CHỮ HOA, Title, Sentence, camelCase, PascalCase, snake_case, kebab-case, CONSTANT_CASE hay dot.case.