# Changelog

Lịch sử phiên bản của các API và tài liệu HiTechCloud Developers: sản phẩm mới, endpoint mới, cải tiến và các thay đổi phá vỡ tương thích được báo trước.

_Nguồn: https://developers.hitechcloud.vn/tai-lieu/changelog · Tài liệu HiTechCloud Developers_

Trang này ghi lại các thay đổi của nền tảng API HiTechCloud: sản phẩm mới, endpoint mới, cải tiến và thay đổi phá vỡ tương thích (breaking change). Mục mới nhất ở trên cùng.

> Chúng tôi tuân theo [SemVer](https://semver.org): thay đổi phá vỡ tương thích chỉ phát hành ở phiên bản lớn (major) và luôn được báo trước tại đây cùng webhook `announcement.published`. Hãy theo dõi trang này hoặc đăng ký webhook để nhận thông báo.

- **Trạng thái API** — Mọi API đang hoạt động ổn định.
- **Nhịp phát hành** — Tính năng mới hàng tuần; breaking change báo trước tối thiểu 90 ngày.
- **Nhận thông báo** — Đăng ký webhook `announcement.published` để tự động nhận tin. (/webhooks)

## 2026-11-01 · v2.7

### Bộ SDK đa ngôn ngữ (mã nguồn mở)

- Phát hành bộ SDK chính thức trên GitHub (org `hitechcloudvn`) cho Node/TypeScript, Python, PHP, Go và Java: **HiTechCloud SDK** (User API), **Tools SDK**, **VNeID SDK**, **HiTechPos SDK**, **Omnichannel SDK**, **CRM SDK**, **WAF SDK**, **Sale AI SDK** — kèm OpenAPI, ví dụ, máy chủ MCP và CLI.
- **Laravel package** `hitechcloudvn/laravel-hitechcloudpay` phủ toàn bộ sản phẩm (Pay, eKYC, POS, Omnichannel, CRM, WAF, Sale AI, Tools, User API): migrations, routes webhook + middleware xác minh chữ ký, events, jobs, facade `HiTechCloud`. Tương thích PHP 8.0+ và Laravel 9–13.
- Cài đặt: `composer require hitechcloudvn/laravel-hitechcloudpay`, `npm i @hitechcloudvn/<sdk>`, `pip install hitechcloud-<sdk>`.

### Tài liệu SDK & điều hướng

- Khu **SDK & Ví dụ** riêng tại [/sdk](/tai-lieu/sdk): mỗi bộ SDK có trang tổng quan, cài đặt theo ngôn ngữ, ví dụ, MCP và menu (sidebar) độc lập.
- Tách khu SDK khỏi tài liệu API: trang chủ, tài liệu và API Reference không còn lẫn SDK; nút chuyển sản phẩm hiển thị đúng ngữ cảnh (sản phẩm API hoặc bộ SDK).
- [API Reference](/tai-lieu/reference) liệt kê toàn bộ danh mục sản phẩm kèm sơ đồ kết nối và tìm kiếm trang.

## 2026-10-31 · v2.6

### Sản phẩm mới

- **HiTechCloud WAF** — Tường lửa ứng dụng web (vcwaf): 227 endpoint quản trị site, chính sách, chống bot, SSL, giám sát tấn công, thống kê. Xem [Tổng quan WAF](/tai-lieu/waf/tong-quan).
- **HiTechCloud Sale AI** — Nền tảng chatbot bán hàng đa kênh: kịch bản, từ khoá, chuỗi tin, broadcast, trợ lý AI, đơn hàng từ hội thoại. Xem [Tổng quan Sale AI](/tai-lieu/sale-ai/tong-quan).
- **HiTechCloud CRM** — Quản lý liên hệ, công ty, cơ hội, pipeline, báo giá và tự động hoá. Xem [Tổng quan CRM](/tai-lieu/crm/tong-quan).
- **HiTechPos** — API bán hàng đa kênh: đơn hàng, sản phẩm, tồn kho, kho, khuyến mãi, sổ quỹ, báo cáo. Xem [Tổng quan HiTechPos](/tai-lieu/pos/tong-quan).
- **HiTechCloud Omnichannel** — Hợp nhất hội thoại Facebook, Instagram, Zalo, TikTok, web về một API. Xem [Tổng quan Omnichannel](/tai-lieu/omnichannel/tong-quan).
- **HiTechCloud eKYC** — Xác thực VNeID/eID: eKYC, đọc chip CCCD, so khớp khuôn mặt, chia sẻ dữ liệu C06. Xem [Tổng quan eKYC](/tai-lieu/ekyc-vneid/tong-quan).

### Cải tiến

- Trang chủ tài liệu liệt kê đầy đủ mọi sản phẩm kèm logo và sơ đồ kết nối tổng thể.
- Bổ sung sơ đồ kết nối (flow) và logo thương hiệu thật cho các trang sản phẩm.
- API playground kiểm thử tại chỗ mở rộng cho toàn bộ máy chủ sản phẩm mới (ekyc, omni, pos, crm, waf, sale-ai và bản sandbox).
- Chuẩn hoá thuật ngữ chuyên ngành thống nhất trên toàn bộ tài liệu.

## 2026-10-24 · v2.5

### HiTechCloud Pay

- Ra mắt họ sản phẩm **HiTechCloud Pay**: Cổng thanh toán, Webhooks, Pay API, Loa thông báo, Hoá đơn điện tử và Open Banking.
- Thanh toán VietQR / NAPAS 247 và thẻ quốc tế Visa / Mastercard / JCB qua một phiên thanh toán duy nhất.
- Webhook ký bằng HMAC-SHA256; hỗ trợ idempotency key và cơ chế thử lại (retry).

### Cải tiến

- Bố cục tài liệu API hai cột: mô tả bên trái, mã mẫu dính (sticky) bên phải.
- Tô màu cú pháp cho khối mã; nút sao chép và mở bằng AI trên mỗi trang.

## 2026-10-15 · v2.0

### Nền tảng tài liệu mới

- Cổng tài liệu và Cổng khách hàng dựng lại trên nền tảng mới; đăng nhập bằng **HiTechCloud ID**.
- Công cụ tra cứu chạy ngay trong Cổng khách hàng, không cần nhập khoá.
- Số endpoint và danh mục được đếm trực tiếp từ hệ thống đang chạy.
- Thêm máy chủ **MCP**, tệp `llms.txt` và bộ SDK / CLI cho trợ lý AI.

### Thay đổi phá vỡ tương thích

- Lỗi chuẩn hoá về dạng `ok:false` + `error` + `message` — xem [Mã lỗi](/tai-lieu/ma-loi).
- Xác thực chuyển sang khoá API theo phạm vi (scope) và hạn mức theo khoá — xem [Xác thực](/tai-lieu/xac-thuc).

> Cần lịch sử cũ hơn hoặc nhật ký thay đổi theo từng endpoint? Liên hệ đội hỗ trợ hoặc theo dõi đặc tả OpenAPI của từng sản phẩm.
