API Cloudzone: khách hàng thêm tùy chọn đặt và quản lý dịch vụ thông qua API

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: bạn tự khai, Cloudzone duyệt, rồi hệ thống của bạn 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 đó, bạn khai bốn thứ:

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 bạn nối từ đâu.
3. Nhóm dịch vụ cần dùng - chọn đúng thứ bạn cần, không cần xin 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, bạn tick đồng ý Điều khoản dịch vụ. Hệ thống ghi lại chính bản văn kiện bạn đã đồng ý, để sau này hai bên có cái đố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 để bạn 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 xin 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ỗ đó bạn thấy thêm:

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ủa bạn còn sống hay đã chết lặng.
2. Danh sách IP đang được phép gọi - và bạn 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: bạn 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 bạn đổi người phụ trách, thì tự cấp lại; bộ cũ hết hiệu lực ngay và bạn cập nhật bộ mới vào hệ thống của mình.

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ụ bạn chọn được khi xin quyền:

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 - cho khách chạy AI, dựng hình, xử lý video.
3. Dịch vụ Proxy.
4. Cloudzone Box - lưu trữ đám mây, năm mức dung lượng từ 50 GB đến 1 TB.
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 của bạn hiển thị 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 bên bạn luôn khớp thực tế.

Quyền cấp theo từng nhóm dịch vụ: bạn 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 VPS, hệ thống của bạn gọi được:

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" trong trang của bạn, việc xảy ra thật trên hạ tầng Cloudzone, và không ai phải trực để làm tay.

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 của bạn không có tài khoản Portal Cloudzone, nên họ không đăng nhập bằng đường của Cloudzone được. Thay vào đó, bạ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ự 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 cũng không bị xoá: dịch vụ chỉ tạm treo, dữ liệu còn nguyên, và bạn gia hạn được cả gói đang treo - 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ế để 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ư của bạn 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 bạn kịp nhận ra.

Kèm theo đó là các lệnh đọc để bạn 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 của bạn 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ỉ bạn đã đăng ký trước, và có giới hạn tần suất để một sự cố ở phía bạn 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, để bạn 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 của bạn. Đừng để nó trong mã nguồn đẩy lên kho công khai.
2. Nếu bạn bán lại cho khách của mình, Cloudzone làm việc với bạn, không với khách của bạn. Dịch vụ đứng tên bạn; quan hệ với khách, và nội dung khách lưu trữ, thuộc trách nhiệm của bạn.
3. Thư nhắc gia hạn gửi về email tài khoản của bạn, không gửi cho người dùng cuối. Bạn dùng lệnh đọc ngày hết hạn để tự gửi nhắc theo mẫu của mình.
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 của bạn thì phải dựng riêng, 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, chat với Cloudzone nhé. Bộ phận kỹ thuật hỗ trợ trong suốt quá trình kết nối API.