Skip to main content
💬
0 discussions

Hướng Dẫn Sử Dụng Larkbase để Quản Lý Dữ Liệu Front Store

1. Điều kiện tiên quyết​

Để sử dụng hiệu quả Larkbase trong dự án Front Store, người dùng cần:

  • Tài khoản đăng nhập qua Google, Apple hoặc Email.
  • Kiến thức cơ bản về bảng tính (Excel hoặc Google Sheets).

2. Đối tượng đọc​

Tài liệu này dành cho:

  • Thành viên kỹ thuật và phi kỹ thuật trong nhóm dự án Front Store.
  • Người dùng cần lưu trữ, quản lý và truy xuất dữ liệu một cách trực quan và có cấu trúc.

3. Giới thiệu tổng quan​

Larkbase là một nền tảng lưu trữ dữ liệu bảng (table-based) tương tự như Excel nhưng được tích hợp các tính năng quản lý dữ liệu hiện đại như liên kết bảng, phân quyền, truy vấn API, thống kê và trực quan hóa dữ liệu.

Sử dụng Larkbase giúp:

  • Tối ưu quản lý dữ liệu trong giai đoạn hệ thống Admin chưa hoàn thiện.
  • Hạn chế lỗi thủ công và rút ngắn thời gian xử lý dữ liệu.
  • Dễ dàng tích hợp với các hệ thống khác qua API.

4. Chi tiết sử dụng​

4.1. Cấu trúc bảng dữ liệu​

Hiện tại, Larkbase được dùng để lưu trữ:

  • Metadata của bài viết: bao gồm tiêu đề, mô tả, trạng thái...
  • Thông tin thanh toán từ người dùng Front Store.
  • Các bảng như Service, Product, Order được thiết kế riêng biệt theo loại dữ liệu.

Ví dụ bảng lưu trữ bài viết:

Ví dụ bảng lưu thông tin thanh toán:

Thống kê lịch sử giao dịch:

4.2. Thiết lập liên kết giữa các bảng​

Larkbase hỗ trợ liên kết giữa các bảng để tăng tính nhất quán và giảm trùng lặp dữ liệu.

Cách tạo liên kết hai chiều:​

  1. Tạo bảng mới bằng New Table.
  2. Nhấn đúp vào cột cần liên kết → chọn Field type.
  3. Chọn Two-way link.
  4. Ở mục Link to, chọn bảng muốn liên kết.
  5. Kích hoạt Allow adding multiple records nếu cần liên kết nhiều bản ghi.
  6. Nhấn Confirm để hoàn tất.

Minh họa:

4.3. Truy vấn dữ liệu qua API​

Larkbase cho phép truy vấn dữ liệu từ bên ngoài qua API. Đây là tính năng hữu ích cho backend và các hệ thống tự động hóa.

Mẫu URL truy vấn:​


https\://\<your\_domain>.sg.larksuite.com/base/\<app\_token>?table=\<table\_id>\&view=\<view\_id>

Có hai loại access token cần sử dụng:​

  • tenant_access_token: đại diện cho toàn bộ hệ thống.
  • user_access_token: đại diện cho người dùng cá nhân (qua OAuth 2.0).

5. Hướng Dẫn Lấy Access Token từ Larkbase​

5.1. Đăng ký ứng dụng​

  1. Truy cập: https://open.feishu.cn/
  2. Tạo một ứng dụng mới.
  3. Lưu lại App ID và App Secret.

Đảm bảo cấp đủ quyền (scope) truy cập API trong phần cấu hình ứng dụng.

5.2. Lấy tenant_access_token​

POST https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal/

Content-Type: application/json

{
  "app_id": "YOUR_APP_ID",
  "app_secret": "YOUR_APP_SECRET"
}

Kết quả:

{
  "code": 0,
  "msg": "ok",
  "tenant_access_token": "t-gpOabcxyz123456...",
  "expire": 7200
}
  • Token hiệu lực trong 7200 giây (2 tiếng).
  • Dùng cho các truy vấn hệ thống.

5.3. Lấy user_access_token qua OAuth 2.0​

Bước 1: Lấy mã code​

Truy cập URL dưới đây trên trình duyệt:

https://open.feishu.cn/open-apis/authen/v1/index?app_id=YOUR_APP_ID&redirect_uri=YOUR_REDIRECT_URI&state=custom_value

→ Sau khi đăng nhập và cấp quyền, hệ thống sẽ redirect về redirect_uri kèm code.

Bước 2: Dùng code để lấy access token​

POST https://open.feishu.cn/open-apis/authen/v1/access_token

Content-Type: application/json

{
  "grant_type": "authorization_code",
  "code": "CODE_FROM_REDIRECT"
}

Kết quả:

{
  "code": 0,
  "msg": "ok",
  "data": {
    "access_token": "user-access-token-abc...",
    "expires_in": 7200,
    "refresh_token": "user-refresh-token-xyz...",
    ...
  }
}

5.4. Làm mới token​

POST https://open.feishu.cn/open-apis/authen/v1/refresh_access_token

Content-Type: application/json

{
  "grant_type": "refresh_token",
  "refresh_token": "your_refresh_token_here"
}

✅ Ghi chú quan trọng​

  • Access token hết hạn nhanh, cần tự động hóa quá trình refresh.
  • Không chia sẻ app_secret ở phía client.
  • Khuyến nghị lưu trữ token và xử lý API ở backend để đảm bảo an toàn.

6. Kết luận​

Tài liệu này nhằm giúp bạn:

  • Hiểu rõ cách quản lý dữ liệu trong dự án Front Store bằng Larkbase.
  • Thiết lập các bảng và liên kết bảng hiệu quả.
  • Tích hợp hệ thống với API thông qua access token bảo mật.