HitechCloud User API
Điều khiển tài khoản HitechCloud của bạn bằng mã: xem và gia hạn dịch vụ, quản lý tên miền và DNS, đọc hoá đơn và thanh toán, mở ticket hỗ trợ, thao tác với máy chủ ảo và chứng chỉ SSL. Tất cả những gì làm được trong portal, làm được ở đây.
348 endpoint, chia thành 38 nhóm. Mọi phản hồi đều là JSON.
Bắt đầu
Hai môi trường
Tài khoản thử
Dùng ngay trên ote.hitechcloud.vn. Tài khoản này có sẵn 3 dịch vụ, 3 hoá đơn, 3 tên miền, 2 ticket và số dư mẫu — đủ để thử hết các luồng đọc và ghi. Bạn cũng có thể tự đăng ký tài khoản thử qua POST /signup.
demo@ote.hitechcloud.vn
W9vTyPuJLyTVHAJ3Fe3Coi2h
TOKEN=$(curl -s -X POST "https://ote.hitechcloud.vn/login" \
-H "Content-Type: application/json" \
-d '{"username":"demo@ote.hitechcloud.vn","password":"W9vTyPuJLyTVHAJ3Fe3Coi2h"}' \
| grep -o '"token":"[^"]*"' | cut -d'"' -f4)
curl -s "https://ote.hitechcloud.vn/service" \
-H "Authorization: Bearer $TOKEN"
Dữ liệu thử tách hoàn toàn khỏi hệ thống thật. Endpoint nào chưa mô phỏng thì trả 501 kèm lời nhắn rõ ràng, không trả dữ liệu bịa.
Gọi từ Postman
https://api.hitechcloud.vn/login hoặc /api/login. Máy chủ tự bỏ phần /api thừa.
/login chỉ nhận POST — gọi bằng GET sẽ nhận {"error":["invalid method"]}.
x-www-form-urlencoded, hoặc gửi JSON, hoặc để trên query string. Cả ba đều được.
120 lượt/phút trên mỗi IP tại lớp trung gian, và giới hạn tốc độ của chính máy chủ gốc. Chạm trần trả 429 kèm header Retry-After.
curl -L -X POST "https://api.hitechcloud.vn/api/login" -d "username=ban@congty.vn" -d "password=matkhau"
curl "https://api.hitechcloud.vn/api/login?username=…&password=…"
{"error":["invalid method"]}
Xác thực
POST /login với username và password. Phản hồi chứa trường token.
Authorization: Bearer <token> trong mọi lời gọi cần đăng nhập.
POST /token để lấy token mới, không cần nhập lại mật khẩu.
POST /logout huỷ token đang dùng. POST /revoke huỷ toàn bộ token của tài khoản.
401 với {"error":["unauthorized"]}.