Hoàn thành bài "Bài 5: Làm Quen với Sanity CMS" trước để mở khoá bài này.Đến bài trước

Giới thiệu

Sau khi đã thiết kế schema cho Sanity ở bài trước, bước tiếp theo là kéo dữ liệu từ Sanity về trang HTML tĩnh. Sanity cung cấp một REST API công khai — ta gửi một HTTP request kèm theo GROQ query (ngôn ngữ truy vấn của Sanity) tới dataset, và nhận về JSON chứa toàn bộ nội dung. Trong bài này, ta sẽ dùng JavaScript thuần (không cần framework) để gọi API, parse JSON, rồi render ra DOM.

Hai khái niệm cốt lõi cần nắm: GROQ (Graph-Relational Object Queries) — cú pháp truy vấn giống SQL nhưng linh hoạt hơn, cho phép lọc, sắp xếp, chọn field cần trả về. Content Lake — kho dữ liệu của Sanity lưu trên cloud, truy cập qua URL dataset, ví dụ `https://YOUR_PROJECT_ID.api.sanity.io/v1/data/query/production`.

Chuẩn bị: lấy thông tin cần thiết

Để gọi được API, bạn cần ba thứ:

Project ID — xem trong trang quản trị Sanity (https://www.sanity.io/manage), dạng chuỗi 8-10 ký tự ngẫu nhiên. Dataset — tên dataset đã tạo lúc setup (mặc định thường là production). GROQ query — câu lệnh truy vấn bạn muốn thực thi.

Nếu muốn public access (ai cũng đọc được), bạn cần vào Sanity Dashboard > API > Tokens, tạo token với quyền Viewer. Token này gắn vào header `Authorization: Bearer <token>`.

sơ đồ luồng từ trình duyệt gửi request đến Sanity Content Lake và nhận về JSON

Cú pháp GROQ cơ bản

Cú pháp GROQ có dạng `*[_type == "ten_schema"]` để lọc tất cả document thuộc loại đó. Ví dụ, lấy toàn bộ sản phẩm sắp xếp theo ngày tạo mới nhất:

javascript
const groqQuery = `*[_type == "product"] | order(_createdAt desc) {
_id,
title,
slug,
price,
mainImage{
asset->{url}
}
}`;

Toán tử `->` dùng để "tham chiếu" — trong schema bạn đã khai báo field kiểu image hay reference, đây là cách lấy nội dung thật của đối tượng liên kết. Hàm `order()` sắp xếp kết quả.

Gọi API bằng JavaScript thuần

File `js/fetch-products.js` đặt trong thư mục gốc của website HTML:

javascript
const PROJECT_ID = 'your_project_id_here';
const DATASET = 'production';
const TOKEN = 'your_viewer_token_here';
async function loadProducts() {
const query = encodeURIComponent(`*[_type == "product"] | order(_createdAt desc) {
_id, title, slug, price, mainImage{asset->{url}}
}`);
const url = `https://${PROJECT_ID}.api.sanity.io/v1/data/query/${DATASET}?query=${query}`;
const response = await fetch(url, {
headers: {
'Authorization': `Bearer ${TOKEN}`
}
});
const data = await response.json();
return data.result;
}

Server Sanity trả về JSON có cấu trúc `{ result: [...] }`. Mảng `result` chính là danh sách sản phẩm bạn truy vấn.

Render danh sách sản phẩm ra HTML

Sau khi gọi API thành công, ta render từng sản phẩm vào một container đã chuẩn bị sẵn trong HTML:

javascript
async function renderProducts() {
const products = await loadProducts();
const container = document.getElementById('product-list');
container.innerHTML = products.map(product => `
<div class="product-card">
<img src="${product.mainImage.asset.url}" alt="${product.title}">
<h3>${product.title}</h3>
<p class="price">${product.price.toLocaleString('vi-VN')}đ</p>
<a href="/sanity_cms/products/${product.slug.current}.html">Xem chi tiết</a>
</div>
`).join('');
}
renderProducts();

Hàm `map()` duyệt qua từng sản phẩm, tạo chuỗi HTML, sau đó `join('')` nối lại thành một chuỗi duy nhất gán vào `innerHTML`. Lưu ý trang chi tiết cần được sinh ra từ Sanity — ở phần nâng cao bạn có thể dùng webhook hoặc Netlify build hook để tự sinh file HTML mỗi khi content thay đổi.

Lỗi thường gặp

Sai Project ID — lỗi 401 hoặc 404 ngay lập tức, kiểm tra lại ID trong Sanity manage dashboard. Thiếu token — nếu dataset chưa bật public access, mọi request phải có Bearer token hợp lệ. Field truy vấn không tồn tại — GROQ rất strict, truy vấn field name sai sẽ trả về null hoặc lỗi, kiểm tra lại schema. Ảnh không hiển thị — URL ảnh nằm ở `mainImage.asset.url`, thiếu một cấp `asset->` sẽ không lấy được link ảnh thật.

Tổng kết

Kết nối Sanity với website HTML chỉ cần 3 bước: viết GROQ query, gửi fetch request kèm token, render kết quả ra DOM. Mọi thao tác đều chạy ở client-side nên không cần backend riêng. Khi đã có danh sách hiển thị được, bạn có thể mở rộng thêm cho bài viết, danh mục, hoặc trang chi tiết với cùng cấu trúc.

Luyện tập sau buổi học

Bài kiểm tra cuối bài

Ôn lại kiến thức, thử sức và nhận góp ý cho bài làm.

0/1
Đã trả lời · 0/1