Giúp bạn làm quen với Cubable dễ dàng hơn
Làm quen với Cubable
Sử dụng Cubable
Quản trị Workspace
Vẫn cần hỗ trợ?
Vui lòng liên hệ Bộ phận hỗ trợ
Mục lục
Để nhận dữ liệu từ bên ngoài gửi về, trước tiên bạn cần thiết lập một Board API trên Cubable.
Các bước thiết lập Board API
- Bước 1: Chọn biểu tượng “API" > Chọn “API mới"
- Bước 2: Điền các trường thông tin: “Tên API" (bắt buộc), “Mô tả" (không bắt buộc)
- Bước 3: Chọn “API Key" > Chọn “Interface mới" > Nhập “Tên Interface". Trong API dạng JSON, bạn phải lấy Tên Interface đã thiết lập làm “Key” để gửi dữ liệu đến đúng trường mong muốn.
- Bước 4: Chọn trường cần liên kết với Interface. Khi gọi API có Property tương ứng với Tên Interface nào thì dữ liệu sẽ được gửi đến đúng trường tương ứng với Tên Interface đó.
- Bước 5: Chọn “Lên lịch API" nếu muốn thiết lập thời gian hết hạn của API > Chọn “Ngày hết hạn". Ngày hết hạn được tính từ thời điểm API Token hoạt động.
- Bước 6: Bấm nút “Kích hoạt API" > Bấm “Tạo"
Lưu ý:
Khi gọi API trên Cubable, mỗi lần chỉ được tạo 1 hàng (item) trong Bảng (Board).
Danh sách các trường hỗ trợ nhận dữ liệu API và các value data type trên Cubable
|
Các trường hỗ trợ |
Value data type |
Interface |
Mẫu |
Ghi chú |
|
Checkbox |
boolean |
{ "key": value } |
{ "Checkbox": true } |
Value = true/false |
|
Date |
number/string |
{ "key": "value" } |
Value với data type = number { "Date": 1698338140229 } Value với data type = string { "Date": "2023-10-26T16:35:40.229Z" } |
Value nhập cần theo chuẩn unix timestamp tham khảo tại: https://www.timestamp-converter.com/ |
|
Dropdown |
number |
{ "key": value } |
{ "Dropdown": 1698122505268 } |
Value phải là option ID tương ứng với các option được tạo trong field dropdown list Nơi lấy option ID |
|
|
string |
{ "key": "value" } |
{ "Email": "doleduan920@gmail.com" } |
Value email cần thỏa format email regex |
|
Location |
string |
{ "key": "value" } |
{ "Location": "93 dpb" } |
N/A |
|
Money |
number |
{ "key": value } |
{ "Money": 100 } |
N/A |
|
Number |
number |
{ "key": value } |
{ "Number": 28 } |
N/A |
|
Paragraph |
object |
{ "key": { "title": "value", "content": "value" } } |
{ "Paragraph": { "title": "123", "content": "test" } } |
N/A |
|
Phone |
string |
{ "key": "value" } |
{ "Phone": "0912343249" } |
N/A |
|
Priority |
string |
{ "key": "value" } |
{ "Priority": "urgent" } |
Value gồm 1 trong 4 giá trị:
|
|
Rating |
number |
{ "key": value } |
{ "Rating": 2 } |
Value gồm 5 giá trị: 1, 2, 3, 4, 5 |
|
Text |
string |
{ "key": "value" } |
{ "Text": "test API" } |
N/A |
|
Website |
object |
{ "key": { "text": "value", "link": "value" } } |
{ "Website Link": { "text": "link", "link": "abc.com" } } |
N/A |
JSON mẫu
{
"Checkbox": true,
"Date": "2023-10-26T06:14:23.320Z",
"Dropdown": 1698122505268,
"Email": "help@cubable.com",
"Location": "93 dpb",
"Money": 100,
"Number": 28,
"Paragraph": {
"title": "123",
"content": "test"
},
"Phone": "0912343249",
"Priority": "urgent",
"Rating": 2,
"Text": "test API",
"Website Link": {
"text": "link",
"link": "abc.com"
}
}
Bài viết này hữu ích như thế nào?
Hỗ trợ nhanh