API Cloudzone: tự đăng ký trong Portal, đặt và quản lý dịch vụ từ hệ thống riêng

Kênh API của Cloudzone không mới, nhưng trước đây chỉ mở cho đại lý đã ký hợp tác, và muốn dùng thì phải liên hệ, trao đổi email, chờ cấp. Từ nay việc đó gọn lại thành một mục ngay trong Portal: Quý khách hàng tự khai thông tin, Cloudzone duyệt, rồi hệ thống riêng tự làm việc với hạ tầng.

Điều này không chỉ dành cho người bán lại dịch vụ. Một công ty phần mềm dựng máy ảo cho từng đợt kiểm thử rồi xoá, một đội quảng cáo cần proxy theo chiến dịch, một hệ thống nội bộ muốn tự tạo tài khoản lưu trữ cho khách mới - đều là những việc gọi lệnh xong là chạy, không cần ai bấm tay.

1. Đăng ký API: khai báo trực tiếp trong Portal

Trong Portal Cloudzone đã có mục API ở thanh menu bên trái. Vào đó, khai bốn thông tin:

1. Mục đích sử dụng - viết thật, một hai câu là đủ. Ví dụ "tích hợp đặt proxy tự động từ hệ thống nội bộ của công ty".
2. Website hoặc hệ thống sẽ tích hợp - để Cloudzone biết kết nối đi từ đâu.
3. Nhóm dịch vụ cần dùng - chọn đúng nhóm cần dùng, không cần đăng ký hết.
4. Địa chỉ IP công cộng của máy chủ sẽ gọi API - tối đa năm địa chỉ. Sửa lại được về sau, xem mục 2.

Trước khi gửi, đánh dấu đồng ý Điều khoản dịch vụ. Hệ thống lưu đúng phiên bản điều khoản đã đồng ý, để sau này hai bên có căn cứ đối chiếu.

Gửi xong, trạng thái yêu cầu hiện luôn trên chính trang đó: đang chờ duyệt, đã được cấp, hay chưa được chấp thuận. Được duyệt hay bị từ chối đều có thư báo về email tài khoản, không phải canh trang. Trường hợp chưa được chấp thuận thì lý do hiện ngay kèm form để sửa lại và gửi yêu cầu mới, không phải hỏi lại qua kênh hỗ trợ.

2. Được duyệt: nhận thông tin kết nối sẵn trong Portal

Trước đây thông tin kết nối được gửi một lần, mất là phải yêu cầu cấp lại. Giờ khác: yêu cầu được duyệt thì trang API trong Portal hiện đủ bộ thông tin kết nối, xem lại bất cứ lúc nào, mỗi giá trị có nút chép sẵn.

Cùng chỗ đó còn có:

1. Ngày được cấp quyền và lần gọi API gần nhất - hữu ích để biết đoạn tích hợp còn chạy hay đã ngừng.
2. Danh sách IP đang được phép gọi - và tự sửa được. Đổi máy chủ, thêm một máy nữa, hay nhà mạng cấp cho dải IP khác: sửa ngay tại chỗ, có hiệu lực lập tức, không phải gửi yêu cầu mới rồi chờ duyệt lại.
3. Nút cấp lại khoá. Nghi khoá bị lộ, hoặc đổi người phụ trách, thì tự cấp lại; bộ cũ hết hiệu lực ngay, chỉ cần cập nhật bộ mới vào hệ thống.

Tài liệu API đầy đủ cũng nằm luôn trong Portal, ở trang bên cạnh: đủ các lệnh, quy ước phản hồi, ví dụ, và một bảng lỗi thường gặp kèm nguyên nhân. Không phải đi tìm file tài liệu qua email.

Một điểm nhỏ mà đội tích hợp nào cũng nên đọc trước: mọi phản hồi của API đều trả về HTTP 200, kết quả thật nằm trong trường trạng thái của phản hồi. Đừng chỉ nhìn mã HTTP mà kết luận là gọi thành công.

3. API bao gồm những dịch vụ nào

Các nhóm dịch vụ chọn được khi đăng ký:

1. VPS Việt Nam và VPS nước ngoài - chọn cấu hình, hệ điều hành, chu kỳ thuê.
2. VPS GPU (1 GB VRAM) - đồ hoạ nhẹ, suy luận mô hình rất nhỏ.
3. Dịch vụ Proxy.
4. Cloudzone Box - lưu trữ đám mây, dùng trên trình duyệt hoặc ứng dụng đồng bộ.
5. Hosting - hiện có bộ lệnh quản lý gói đang chạy (xem chi tiết, đổi mật khẩu, gia hạn, huỷ).

Lệnh tra danh mục trả về kèm cấu hình và giá của từng chu kỳ, nên hệ thống riêng hiển thị được bảng giá mà không phải nhập tay và không lo lệch khi Cloudzone đổi giá. Ngoài ra còn có lệnh tra hệ điều hành cho VPS và danh sách vị trí cho proxy, để form đặt hàng luôn khớp thực tế.

Quyền cấp theo từng nhóm dịch vụ: chỉ dùng VPS thì chỉ mở quyền VPS, sau này cần thêm Cloudzone Box thì mở thêm, không phải nối lại từ đầu.

4. Thao tác qua API hoàn toàn tương tự như làm trực tiếp trên Portal Cloudzone

API không chỉ để đặt hàng, mà đủ lệnh cho cả vòng đời dịch vụ. Với Cloud VPS, API cho phép:

1. Bật, tắt, khởi động lại máy.
2. Gia hạn, và bật hoặc tắt tự động gia hạn cho từng máy.
3. Đổi mật khẩu, lấy lại mật khẩu, đổi cổng truy cập từ xa.
4. Nâng cấu hình máy đang chạy - thêm CPU, thêm RAM, thêm ổ đĩa, không phải dựng máy mới rồi chuyển dữ liệu.
5. Mở rộng ổ đĩa và cài lại hệ điều hành - phần cài lại đi hai bước, chọn rồi xác nhận, để một lệnh gọi nhầm không xoá mất dữ liệu.
6. Huỷ dịch vụ khi không dùng nữa.

Dịch vụ Proxy có bộ lệnh tương ứng ở mức phù hợp: xem danh sách và chi tiết, đổi mật khẩu, gia hạn, tự động gia hạn, huỷ.

Nghĩa là người dùng bấm nút "khởi động lại" trên trang quản trị riêng, việc xảy ra thật trên hạ tầng Cloudzone, và không ai phải trực để làm tay.

Cần tư vấn trước khi kết nối API? Mời Quý khách hàng chat với Cloudzone.

5. Cloudzone Box qua API

Cloudzone Box là nhóm dịch vụ mới nhất mở cho kênh API, và có một điểm riêng cần nói rõ.

Người dùng cuối không có tài khoản Cloudzone Portal, nên họ không đăng nhập bằng đường của Cloudzone được. Thay vào đó, chỉ cần gọi một lệnh để đặt mật khẩu cho tài khoản Box rồi giao cặp thông tin đó cho họ. Họ dùng nó để vào Box trên trình duyệt, hoặc nhập vào ứng dụng đồng bộ để Box hiện ra như một thư mục ngay trên máy.

Cloudzone không lưu mật khẩu này: nó chỉ xuất hiện đúng một lần trong phản hồi, bên tích hợp tự giữ và giao lại. Quên thì gọi lại lệnh để đặt mật khẩu mới, mật khẩu cũ hết hiệu lực ngay.

Phần còn lại của vòng đời cũng gọi được: xem danh sách gói kèm dung lượng đã dùng, gia hạn, và nâng gói. Hai điểm đáng nhớ khi nâng gói:

1. Chỉ thu phần chênh của thời gian chưa dùng, không thu trọn chu kỳ mới, và ngày hết hạn không đổi.
2. Dữ liệu nguyên vẹn - vẫn tài khoản đó, thư mục đó, dung lượng mới tự cộng vào sau vài phút.

Gói hết hạn không bị xoá ngay: dịch vụ tạm treo, dữ liệu được giữ trong thời gian ghi ở quy định sử dụng; gia hạn trong thời gian đó là vài phút sau vào lại bình thường.

6. Cơ chế kiểm tra và đối soát chặt chẽ

Đặt hàng tự động thì nỗi lo lớn nhất là vấn đề thanh toán: đặt lệnh xong, thanh toán rồi mà dịch vụ có thể bị lỗi/chưa cung cấp. Cloudzone thực hiện ba cơ chế để Quý khách hàng yên tâm:

1. Kiểm tra khả năng cung cấp dịch vụ trước khi trừ tiền. Hết hàng thì lệnh trả lỗi ngay, số dư không bị chạm tới.
2. Đơn bị từ chối được hoàn tiền tự động vào số dư, không cần mở phiếu hỗ trợ.
3. Đơn đã trả tiền mà kẹt sẽ tự báo về Cloudzone để đội vận hành xử lý, thường là trước khi khách kịp nhận ra.

Kèm theo đó là các lệnh đọc để tự đối soát: xem số dư hiện tại, lấy thông tin nạp tiền, tạo yêu cầu nạp, kiểm tra một giao dịch, lấy lịch sử giao dịch. Bảng lỗi trong tài liệu ghi rõ trường hợp nào chưa trừ tiền để hệ thống tích hợp biết có nên gọi lại hay không.

Về an toàn, kênh API dùng xác thực nhiều lớp, chỉ nhận lời gọi từ địa chỉ IP đã đăng ký trước, và có giới hạn tần suất để một sự cố ở phía hệ thống tích hợp không kéo theo hàng loạt đơn sai.

7. Vài điều nên biết trước khi kết nối API

Nói trước cho rõ ràng, để tính đúng ngay từ đầu:

1. Giữ kín bộ thông tin kết nối. Ai có đủ bộ và gọi từ IP đã cấp phép đều đặt được dịch vụ và trừ tiền từ tài khoản. Đừng để nó trong mã nguồn đẩy lên kho công khai. Xem thêm Token API là gì và có an toàn không.
2. Khi bán lại cho khách của mình, Cloudzone làm việc với bên bán lại, không làm việc với khách cuối. Dịch vụ đứng tên tài khoản đăng ký API; quan hệ với khách cuối, và nội dung khách lưu trữ, thuộc trách nhiệm của bên bán lại.
3. Thư nhắc gia hạn gửi về email tài khoản đăng ký, không gửi cho người dùng cuối. Dùng lệnh đọc ngày hết hạn để tự gửi nhắc theo mẫu riêng.
4. Giao diện Cloudzone Box mang thương hiệu Cloudzone. Cần trắng nhãn hoàn toàn theo thương hiệu riêng thì phải dựng riêng (tham khảo White-label Cloud sPortal), liên hệ Cloudzone để bàn phương án.

8. Bắt đầu thế nào

1. Đăng nhập Portal Cloudzone, mở mục API ở menu bên trái.
2. Khai mục đích, hệ thống sẽ tích hợp, nhóm dịch vụ cần dùng và IP máy chủ sẽ gọi API. Gửi yêu cầu.
3. Cloudzone xem xét rồi cấp quyền. Được duyệt là thông tin kết nối và tài liệu hiện ngay trong Portal.
4. Nạp số dư, chạy thử một đơn thật, rồi mở rộng dần.

Chưa có tài khoản Portal, hoặc muốn nghe chính sách dành cho đối tác bán lại trước khi quyết định, mời Quý khách hàng chat với Cloudzone. Bộ phận kỹ thuật hỗ trợ trong suốt quá trình kết nối API.

9. Câu hỏi thường gặp về API Cloudzone

9.1. Đổi IP máy chủ thì làm gì?

Tự sửa danh sách IP trong trang API của Portal, có hiệu lực ngay.

9.2. Nghi khoá bị lộ thì sao?

Bấm cấp lại khoá; bộ cũ hết hiệu lực ngay.

9.3. API trả HTTP 200 là gọi thành công?

Chưa chắc. Xem trường trạng thái trong phản hồi.