# REST API tùy biến

> Nối phần mềm bất kỳ có REST API trả JSON (POS, CRM, kho, ERP nội bộ) bằng cách khai báo địa chỉ gốc, xác thực, endpoint và phân trang, rồi thử gọi trước khi thêm.

Dùng connector này khi phần mềm của bạn không có trong [thư viện](/vi/docs/sources/connector-library) nhưng có REST API trả JSON. Cần gói Khởi đầu trở lên.

## 1. Địa chỉ và xác thực

- **Địa chỉ gốc API**: bắt đầu bằng `https://`. DataxLand chỉ gửi yêu cầu tới đúng host của địa chỉ này.
- **Xác thực**:

| Kiểu | Bạn điền |
| --- | --- |
| Không xác thực | — |
| API key | Khóa, **Tên header hoặc tham số**, **Gửi trong** header hoặc query |
| Bearer token | Token |
| Basic (tên đăng nhập, mật khẩu) | Tên đăng nhập, mật khẩu |
| OAuth2 client credentials | Token URL, Client ID, Client secret, Scope |

- **Header thêm** (tối đa 30): header cố định API cần. Không đặt bí mật ở đây; bí mật thuộc ô xác thực, được mã hóa khi lưu.

## 2. Endpoint

Mỗi endpoint (1–20) thành một bảng:

| Ô | Ví dụ |
| --- | --- |
| Tên bảng | `orders` |
| Đường dẫn | `/v1/orders` |
| Tham số | `updated_from` = `{{ start_date }}` |
| Đường dẫn tới danh sách bản ghi | `data.items` |
| Khóa chính | `id` |
| Phân trang | xem bên dưới |
| Số trang tối đa | mặc định 1000 |

**Phân trang**: Không phân trang, Theo số trang, Theo vị trí (limit/offset), Theo con trỏ, Theo link trang sau.

Ô chung: **Lấy dữ liệu từ ngày** (giá trị của `{{ start_date }}`) và **Thời gian chờ mỗi lần gọi (giây)**, mặc định 30.

## 3. Thử gọi

Bấm **Thử gọi**: DataxLand gọi endpoint, hiện tối đa 20 bản ghi và **Cột suy ra**, thông tin cá nhân đã được che. Sửa đường dẫn danh sách hay phân trang tới khi đúng, rồi thêm nguồn.

## Giới hạn hiện tại

- Gọi bằng GET, POST hoặc GraphQL; phản hồi dạng JSON.
- Mỗi lần làm mới đọc lại toàn bộ (lọc từ **Lấy dữ liệu từ ngày**).

## Liên quan

- [Thư viện connector](/vi/docs/sources/connector-library)
- [Kết nối dữ liệu](/vi/docs/connect-data)
- [Che thông tin cá nhân](/vi/docs/review/pii)
