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.

Xem Markdown

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: 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 APIMọi API đang hoạt động ổn định.
Nhịp phát hànhTí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.

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: 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 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.
  • 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.
  • 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.
  • 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.
  • HiTechCloud Omnichannel — Hợp nhất hội thoại Facebook, Instagram, Zalo, TikTok, web về một API. Xem Tổng quan Omnichannel.
  • 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.

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.
  • 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.
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.