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

Chuyển giữa chữ Việt và chuỗi phím của ba kiểu gõ thông dụng (`method` =

`telex`, `vni`, `viqr`). `direction=encode` sinh chuỗi phím từ chữ Việt và luôn chính xác; `direction=decode` (mặc định) làm ngược lại và là phép MÔ PHỎNG bộ gõ, nên có mơ hồ cố hữu — danh sách giới hạn cụ thể của từng kiểu trả thẳng trong trường `limits` của phản hồi. Tham số `tone_style` chọn trường phái đặt dấu thanh cho ba vần mở `oa`, `oe`, `uy`: `moi` cho `hòa, khỏe, thủy` (mặc định, theo sách giáo khoa hiện hành) và `cu` cho `hoà, khoẻ, thuỷ`. Cả hai cách viết đều đúng chính tả.

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

Cần khoá API

Tham số

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

Chuỗi cần chuyển, tối đa 5.000 ký tự.

method string · truy vấn

Kiểu gõ: telex (mặc định), vni hoặc viqr.

direction string · truy vấn

decode chuỗi phím sang chữ Việt (mặc định), encode chữ Việt sang chuỗi phím.

tone_style string · truy vấn

Trường phái đặt dấu thanh khi giải mã: moi (hòa, thủy — mặc định) hoặc cu (hoà, thuỷ).

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.

curl --location 'https://api-tools.hitechcloud.vn/api/opendata/text/typing?text=GIA_TRI&method=GIA_TRI&direction=GIA_TRI&tone_style=GIA_TRI' \ --header 'X-API-Key: $HITECH_API_KEY' \ --header 'Accept: application/json'

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

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