Cài và đăng nhập EcomWeb CLI

EcomWeb CLI là công cụ dòng lệnh để làm việc với cửa hàng, ví dụ xem sản phẩm, cập nhật đơn hàng, quản lý dữ liệu tùy chỉnh và lấy code giao diện. Trợ lý AI như Claude Code và Codex cũng dùng CLI để làm việc trên cửa hàng của bạn.

Bạn đăng nhập bằng cách duyệt trên trình duyệt, không cần khóa API. CLI dùng đúng vai trò của bạn ở từng cửa hàng.

Cài CLI

CLI cần Node.js 24 trở lên. Lệnh cài dùng npm, có sẵn khi bạn cài Node.js.

1. Cài Node.js từ nodejs.org nếu máy chưa có.
2. Mở terminal.
3. Chạy lệnh cài bên dưới.

# Cài EcomWeb CLI cho cả máy
$ npm install -g @ecomweb/cli
# Kiểm tra CLI đã cài
$ ecomweb --help

Không muốn cài, bạn chạy từng lệnh qua npx, ví dụ npx @ecomweb/cli auth login.

Đăng nhập

1. Chạy lệnh đăng nhập bên dưới. Terminal hiện một mã gồm 8 chữ cái và mở trình duyệt.
2. Đăng nhập bảng điều khiển nếu trình duyệt yêu cầu.
3. Trên trang Đăng nhập ecomweb CLI?, so Mã với mã trong terminal.
4. Nếu hai mã khớp, bấm Cho phép.
5. Khi trang báo Đã cho phép, quay lại terminal.
6. Nếu bạn có nhiều cửa hàng, chọn cửa hàng muốn làm việc trong danh sách hiện ra.

$ ecomweb auth login
# Hoặc đăng nhập và chọn luôn một cửa hàng
$ ecomweb auth login --store-ref <mã cửa hàng>

Trang Đăng nhập ecomweb CLI? cũng cho biết Thiết bị đang xin đăng nhập và địa chỉ gửi yêu cầu. Nếu bạn không vừa chạy lệnh đăng nhập, bấm Từ chối.

Nếu trình duyệt không tự mở, mở đường dẫn terminal in ra. Nếu trang hiện ô Nhập mã đăng nhập, nhập mã rồi bấm Tiếp tục. Mã chỉ dùng được một lần và hết hạn sau 10 phút. Khi trang báo Mã không còn hiệu lực, chạy lại lệnh đăng nhập.

Chọn cửa hàng làm việc

Mọi lệnh làm việc trên cửa hàng đang chọn. Mã cửa hàng là phần sau /store/ trên thanh địa chỉ khi bạn mở cửa hàng trong bảng điều khiển.

# Xem các cửa hàng của bạn
$ ecomweb stores list
# Đổi sang cửa hàng khác
$ ecomweb stores switch <mã cửa hàng>
# Xem cửa hàng đang chọn
$ ecomweb stores current

Muốn chạy một lệnh trên cửa hàng khác mà không đổi cửa hàng đang chọn, thêm –store-ref vào lệnh đó.

Chạy vài lệnh đầu tiên

Kết quả mặc định là JSON, dễ cho script và trợ lý AI đọc. Thêm –output table để xem dạng bảng.

$ ecomweb products list --output table
$ ecomweb orders list --output table
# Xem mọi nhóm lệnh
$ ecomweb --help
# Xem các lệnh và tùy chọn của một nhóm
$ ecomweb products --help

Nhiều lệnh thay đổi dữ liệu nhận –dry-run để xem trước mà không thay đổi gì. Xem ecomweb <lệnh> --help để chắc lệnh đó có hỗ trợ.

Kiểm tra và đăng xuất

# Bạn đang đăng nhập bằng tài khoản nào
$ ecomweb auth status
# Đăng xuất và hủy phiên của CLI này
$ ecomweb auth logout

Để chạy CLI trong CI hoặc trên máy chủ, tạo một khóa API với đúng phạm vi cần dùng, xem Tạo và quản lý khóa API.

Câu hỏi thường gặp