Ứng dụng khác
Kết nối REST API tùy biến với DataxLand
Connector REST API tùy biến của DataxLand đọc dữ liệu JSON từ API của phần mềm bất kỳ - POS, phần mềm bán hàng, kho, CRM hay ERP nội bộ - khi chưa có connector dựng sẵn. Ví dụ, nếu phần mềm quản lý bán hàng bạn đang dùng (Haravan, Sapo, KiotViet, Nhanh.vn hay phần mềm khác) có REST API, bạn khai địa chỉ gốc, cách xác thực và từng endpoint cần đọc; mỗi endpoint thành một bảng trong kho của workspace. Connector chỉ gọi GET và chỉ gọi đúng máy chủ của địa chỉ gốc, nên không thể ghi hay xóa gì trên hệ thống của bạn.
Gói Miễn phí không thời hạn · Không cần thẻ thanh toán · Workspace mẫu mở trong vài phút
Làm được gì với REST API tùy biến
- Đưa đơn hàng, sản phẩm và tồn kho từ phần mềm bán hàng có API vào dashboard lãi lỗ đa kênh.
- Ghép dữ liệu phần mềm nội bộ với sàn, quảng cáo và bảng giá vốn trên Google Sheets.
- Thử nghiệm nhanh một nguồn mới trước khi có connector riêng cho nó.
Dữ liệu bạn nhận được
Mỗi luồng thành một bảng riêng trong kho của workspace, giữ nguyên trạng; cột thông tin cá nhân được băm khi nạp.
| Luồng (bảng) | Nội dung |
|---|---|
| <tên endpoint> | Mỗi endpoint bạn khai (tên bảng, đường dẫn, tham số) thành một bảng raw.<tên nguồn>__<tên endpoint>. |
| đường dẫn bản ghi | Chỉ ra danh sách bản ghi trong phản hồi, ví dụ data.items; để trống nếu phản hồi là danh sách. |
| phân trang | Theo số trang, theo limit/offset, theo con trỏ hoặc theo link trang sau (kể cả header Link). |
Thông tin kết nối
| Cách đăng nhập | Điền thông tin kết nối (khóa API, tài khoản); được mã hóa khi lưu |
|---|---|
| Cách đồng bộ | Toàn bộ (nạp lại mỗi lần) |
| Thông tin cần điền | Địa chỉ gốc API, Endpoint |
| Nhà phát triển | DataxLand |
| Giấy phép | MIT |
Mật khẩu và khóa được mã hóa khi lưu. Cột thông tin cá nhân được băm khi nạp.
Chỉ số tính từ nguồn này
Định nghĩa thật trong gói phân tích; dashboard và Si dùng chung.
| Chỉ số | Định nghĩa | Đơn vị |
|---|---|---|
| Doanh thu thuần | Giá trị dòng sau giảm giá dòng và voucher đơn đã phân bổ, trừ tiền hoàn cho người mua. Tiền hoàn chỉ trừ ở đây. | Tiền (₫) |
| Số đơn hợp lệ | Số đơn không bị hủy (trạng thái chuẩn khác cancelled). | Số lượng |
| Giá trị đơn trung bình | Doanh thu dòng sau giảm giá chia số đơn hợp lệ.= line_net_total / Số đơn hợp lệ | Tiền (₫) |
| Số sản phẩm bán ra | Tổng số lượng sản phẩm trong các dòng đơn thuộc đơn hợp lệ. | Số lượng |
| Tỷ lệ hủy | Số đơn hủy chia tổng số đơn.= cancelled_orders / all_orders | Tỷ lệ (%) |
| Giá trị tồn kho bình quân | Bình quân giá trị tồn kho cuối ngày trong kỳ = tổng giá trị các ảnh chụp chia số ngày có ảnh chụp.= ops_inventory_value_total / ops_snapshot_days | Tiền (₫) |
Kết nối REST API tùy biến trong 3 bước
- 1
Khai địa chỉ và xác thực
Trong workspace chọn Thêm nguồn → REST API tùy biến, dán địa chỉ gốc (https://…), chọn xác thực - không có, API key, Bearer token, Basic hoặc OAuth2 client credentials.
- 2
Khai endpoint
Thêm tối đa 20 endpoint, mỗi cái có tên bảng, đường dẫn, tham số (dùng được {{ start_date }}), đường dẫn tới danh sách bản ghi, khóa chính và kiểu phân trang.
- 3
Kiểm tra và duyệt
Bấm Kiểm tra kết nối, xem mẫu dữ liệu; Si đề xuất mỗi bảng là gì trong mô hình chuẩn, bạn duyệt rồi build.
Lưu ý và giới hạn
- Mỗi lần làm mới đọc lại toàn bộ các endpoint; dùng tham số ngày với {{ start_date }} để giới hạn khoảng dữ liệu.
- Mỗi endpoint tối đa 1.000 trang; thời gian chờ mỗi lần gọi mặc định 30 giây, tối đa 300 giây.
- Bí mật chỉ nhập ở mục Xác thực (được mã hóa, không hiển thị lại); không đặt khóa vào header hay tham số.
- DataxLand chưa có connector riêng cho Haravan, Sapo, KiotViet hay Nhanh.vn; cách này phụ thuộc vào API mà nhà cung cấp phần mềm mở cho bạn.
Câu hỏi thường gặp
Connector có ghi dữ liệu lên hệ thống của tôi không?
Không. Connector chỉ gọi GET và chỉ tới đúng máy chủ của địa chỉ gốc; địa chỉ trong mạng nội bộ bị chặn.
API trả XML hoặc CSV thì sao?
Connector đọc JSON. Với CSV, dùng Excel, Google Sheets hoặc nạp vào Postgres trước.
Cần biết lập trình không?
Cần hiểu tài liệu API của phần mềm (endpoint, xác thực, phân trang); không cần viết code.
Mẫu dashboard dùng nguồn này
Kết nối REST API tùy biến và có dashboard đã kiểm số
Gói Miễn phí không thời hạn · Không cần thẻ thanh toán · Workspace mẫu mở trong vài phút