Tổng quan HiTechCloud UserAPI SDK
SDK đa ngôn ngữ chính thức cho HiTechCloud User API — 348 endpoint trên 38 nhóm: dịch vụ, tên miền, DNS, SSL, hoá đơn, hỗ trợ, giỏ hàng, VPS/GPU và hơn thế. Giao diện gọn, nhất quán giữa các ngôn ngữ.
HiTechCloud UserAPI SDK là bộ thư viện client mã nguồn mở (giấy phép MIT) giúp quản lý tài khoản HiTechCloud bằng mã: dịch vụ (VPS, hosting, GPU), tên miền, DNS, chứng chỉ SSL, hoá đơn & thanh toán, ticket hỗ trợ, giỏ hàng/đặt mua và nhiều nhóm khác. SDK bao bọc HiTechCloud User API gồm 348 endpoint trên 38 nhóm, phơi bày dưới dạng các phương thức theo không gian tên (client.services, client.domains, client.dns...).
SDK này làm được gì
- Một client, mọi nhóm tài nguyên — cùng một đối tượng truy cập dịch vụ, tên miền, DNS, SSL, hoá đơn, hỗ trợ... theo không gian tên.
- Đăng nhập & token tự động — truyền
username/passwordđể tự đăng nhập lấy token, hoặc dùng sẵntoken/khoá API. - Bền vững — tự thử lại khi gặp 429 (theo
Retry-After) và 5xx với backoff, tối đa 3 lần; cấu hìnhtimeout,max_retries. - Idiomatic theo ngôn ngữ — đặt tên phương thức và cấu trúc tài nguyên giống nhau giữa các ngôn ngữ, giúp chuyển đổi dễ dàng.
- Hai môi trường — Production (
api.hitechcloud.vn) và OTE/Sandbox (ote.hitechcloud.vn) với dữ liệu mẫu.
Kiến trúc tổng thể
SDK đăng nhập (hoặc nhận token), gắn header xác thực và định tuyến lời gọi tới đúng endpoint /api/....
Các nhóm tài nguyên tiêu biểu
Ngôn ngữ được hỗ trợ
SDK phát hành cho nhiều ngôn ngữ; bộ 7 ngôn ngữ cốt lõi (Python, Node.js, PHP, Go, Ruby, Java, C#) được kiểm thử đầy đủ với CI/CD, các ngôn ngữ còn lại cùng cấu trúc tài nguyên.
| Ngôn ngữ | Gói / kho | Cài đặt |
|---|---|---|
| Python | hitechcloud-sdk (PyPI) | pip install hitechcloud-sdk |
| Node.js | hitechcloud-sdk (npm) | npm install hitechcloud-sdk |
| PHP | hitechcloud/sdk (Composer) | composer require hitechcloud/sdk |
| Go | .../hitechcloud-sdk/go | go get github.com/hitechcloudvn/hitechcloud-sdk/go |
| Ruby | hitechcloud (RubyGems) | gem install hitechcloud |
| Java | vn.hitechcloud:hitechcloud-sdk (Maven) | Maven / Gradle |
| C# | HiTechCloud.SDK (NuGet) | dotnet add package HiTechCloud.SDK |
| Khác | Kotlin, Swift, Rust, Dart/Flutter, R, Julia, Clojure, OCaml, Objective-C, Shell, PowerShell, C | xem trang Cài đặt |