Bắt đầu miễn phí

</> Nhà phát triển

Việc gì làm trong EcomWeb cũng làm được qua API.

Trang quản trị cũng gọi chính API này. Dùng nó để dựng storefront bằng SDK, giao việc vận hành cho trợ lý AI qua CLI, và triển khai giao diện bằng một lệnh.

Bắt đầu miễn phíXem tài liệu API

Trang quản trị

người bán

Storefront

@ecomweb/sdk

Trợ lý AI, CI

@ecomweb/cli

EcomWeb API

REST, mô tả bằng OpenAPI. Khóa truy cập có phạm vi.

Sản phẩmTồn khoĐơn hàngKhách hàngKhuyến mãiNội dungGiao diệnBáo cáo

Một API cho cả cửa hàng.

API cho storefront và API quản trị, mô tả bằng OpenAPI. Có ở mọi gói, kể cả gói Free.

Danh mục

Sản phẩm, biến thể, thuộc tính, bộ sưu tập và tồn kho.

Bán hàng

Đơn hàng, khách hàng, khuyến mãi và phí vận chuyển.

Nội dung

Trang, blog, menu, banner và dữ liệu tùy chỉnh.

Website và báo cáo

Giao diện, tên miền, doanh thu và Google Analytics.

Mỗi khóa truy cập có phạm vi riêng: loại dữ liệu, chỉ đọc, địa chỉ IP, ngày hết hạn.

Xem tài liệu API →

Storefront

Dựng storefront bằng SDK.

Gắn vào dự án Next.js hay JavaScript nào cũng được. SDK có sẵn kiểu TypeScript cho mọi thứ một trang bán hàng cần.

  • Danh mục, tìm kiếm, giỏ hàng, thanh toán và tài khoản khách
  • Trang nội dung, menu, blog, SEO và quy tắc chuyển hướng
  • Dùng fetch, axios hay ky. SDK không ép thư viện HTTP
  • ecomweb storefront init tạo sẵn dự án Next.js đã nối với cửa hàng
Lấy một sản phẩm
import { createEcomwebSdk } from "@ecomweb/sdk";
import { http } from "./http"; // fetch, axios, ky... của bạn

const sdk = createEcomwebSdk({
  publicHttp: http,
  authHttp: http,
});

const product = await sdk.products.getBySlug(
  "723e6d4a", // mã cửa hàng
  "ao-thun-basic",
  { include_variants: true },
);

Vận hành bằng trợ lý AI

Trợ lý làm, bạn duyệt.

CLI được viết cho trợ lý AI. Claude Code, Codex hay quy trình tự động dùng nó để nhập hàng, sửa giá, xử lý đơn và đọc báo cáo.

  • Kết quả dạng JSON, CSV hoặc bảng, lọc bớt trường để trợ lý đọc nhanh
  • ecomweb describe cho trợ lý biết cấu trúc dữ liệu trước khi ghi
  • Lệnh ghi nào cũng chạy thử được với --dry-run
  • Có plugin cho Claude Code và skill cho Codex
  • Mỗi khóa chỉ làm được phần việc đã cấp
Hướng dẫn cho trợ lý AIXem các lệnh
Terminal
# Hàng sắp hết, trả về JSON cho trợ lý đọc
$ ecomweb products list \
    --inventory-status low_stock --output json

# Trợ lý xem cấu trúc dữ liệu trước khi ghi
$ ecomweb describe products --operation update

# Chạy thử, chưa có gì được ghi lên cửa hàng
$ ecomweb products batch-update \
    --file gia-moi.json --dry-run
$ ecomweb deployĐang triển khai
  1. Tải mã nguồn lênupload
  2. EcomWeb build bản mớinext build
  3. Bản xem trước sẵn sàngpreview
  4. Lên trang chính--allow-live

Bản xem trước cho pull request

Xem ổn rồi mới xuất bản

Mở bản xem trước →

Triển khai bằng CLITừ gói Growth

Từ máy bạn lên mạng bằng một lệnh.

Viết storefront ở máy bạn, EcomWeb build và chạy nó. Không cần tự lo máy chủ.

  • ecomweb deploy tạo bản xem trước dùng trong 24 giờ. Ổn rồi mới đưa lên trang chính
  • Gắn vào CI: mỗi pull request một bản xem trước, đẩy lên main là lên trang chính
  • ecomweb logs theo dõi build, deployments rollback quay lại bản trước
  • Biến môi trường quản lý bằng ecomweb env

Chạy trên máy chủ của bạn thì gói nào cũng được. So sánh các gói →

Bắt đầu ngay trong terminal.

Trang quản trị vẫn dùng song song khi bạn cần.

  1. Bước 1

    Đăng nhập

    ecomweb auth login --email. Mã đăng nhập gửi về email, không cần mật khẩu.

  2. Bước 2

    Tạo cửa hàng

    ecomweb init tạo cửa hàng và khóa API cho dự án.

  3. Bước 3

    Lấy storefront

    ecomweb storefront init tạo dự án Next.js đã nối với cửa hàng.

  4. Bước 4

    Đưa lên mạng

    ecomweb deploy, hoặc chạy trên máy chủ của bạn.

Bắt đầu xây trên dữ liệu thật.

Tạo cửa hàng miễn phí, lấy khóa truy cập và gọi API ngay trong buổi đầu.

Bắt đầu miễn phíXem tài liệu API
Làm mọi việc trong EcomWeb qua API | EcomWeb