Giúp bạn làm quen với Cubable dễ dàng hơn

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ợ

Để 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

Email

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ị:

  • Urgent

  • High

  • Normal

  • Low

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