Chuyển đổi & Định dạng opendata/text/normalize

Đổi giữa hai cách lưu chữ có dấu trong bảng mã Unicode

Dạng DỰNG SẴN (`nfc`, mỗi chữ có dấu là một mã điểm) và dạng TỔ HỢP (`nfd`, chữ gốc cộng các dấu rời). Đây là nguyên nhân của lỗi âm thầm tốn nhiều giờ nhất khi làm dữ liệu tiếng Việt: hai chuỗi hiện lên màn hình giống hệt nhau nhưng so sánh bằng nhau lại trả về sai. Tệp xuất từ macOS thường ở dạng tổ hợp; cơ sở dữ liệu và web thường ở dạng dựng sẵn. Phản hồi kèm `detected_form` (dạng của chuỗi gửi lên, có thể là `tron-lan` khi dữ liệu bị ghép từ hai nguồn) và độ dài của cả hai dạng — chênh lệch độ dài chính là bằng chứng trực quan nhất.

GET https://api-tools.hitechcloud.vn/api/opendata/text/normalize Đã chép

Cần khoá API

Tham số

text string · truy vấn bắt buộc

Chuỗi cần chuẩn hoá, tối đa 5.000 ký tự.

form string · truy vấn

Dạng đích: nfc (dựng sẵn, mặc định) hoặc nfd (tổ hợp).

Mã trả về

200 Thành công.

401 Thiếu hoặc sai khoá API. Gửi kèm header X-API-Key.

404 Không tìm thấy dữ liệu tương ứng.

429 Vượt hạn mức của khoá. Xem header Retry-After.

$response = Http::withHeaders([ 'X-API-Key' => env('HITECH_API_KEY'), ])->get('https://api-tools.hitechcloud.vn/api/opendata/text/normalize', [ 'text' => 'GIA_TRI', 'form' => 'GIA_TRI', ]); $data = $response->json();

import os, requests res = requests.get( "https://api-tools.hitechcloud.vn/api/opendata/text/normalize", headers={"X-API-Key": os.environ["HITECH_API_KEY"]}, params={ "text": "GIA_TRI", "form": "GIA_TRI", }, ) data = res.json()