Path

/api/v1/{Project_token}/{ProjectUnit_token}/list

Http Method

GET｜POST

Content-type

application/form-data

query-param｜form-data

skip

（int）
略過前N筆資料；0~N；預設值0（選用）

take

（int）
取N筆資料；0~N；預設值10（選用）

sort

（string）
欄位資料排序；預設值為主索引鍵(id)（選用）
Note：URL Encode string if Http Method is GET

EX：降序

price desc

EX：升序

age asc

EX：

price desc,age

EX：隨機

random()

filter

（string）
篩選欄位；json string（選用）

key 欄位KEY；KEY不存在不比對

value 比對值；空值不比對

operator 比對運算子；預設值'='；使用'='或'<'或'>'或'<='或'>='或'!='或'like'

logical 邏輯運算；選用；預設值'&&'；使用'&&'或'||'或'AND'或'OR'

Note：URL Encode json string if Http Method is GET

EX：

var filter = [
    {
        'key': 'sex',
        'value': '1',
        'operator': '=',
        'logical': '&&'
    },
    {
        'key': 'name',
        'value': 'aa%',
        'operator': 'like',
        'logical': '&&'
    },
    {
        'key': 'age',
        'value': '3',
        'operator': '>=',
        'logical': '&&'
    },
];
JSON.stringify(filter);

columns

（string）
要讀取的欄位Key；json string（選用）
預設：讀取所有的欄位Key
Note：URL Encode json string if Http Method is GET

EX：

var columns = [ "name", "age", "sex" ];
JSON.stringify(columns);

type

（string）
匯出檔案格式；excel或json；預設值：excel（選用）

original

（bool）
true：原始資料｜false：轉換後資料；預設值：false（選用）

key

API金鑰；設定如勾選[驗證金鑰]時為必要（選用｜必要）

請勿於公開資訊端使用API金鑰。若於Client公開資訊端使用，請自行評估其風險及可行性或將程式碼混淆加密壓縮。

Responses

application/ms-excel｜text/plain

錯誤資訊

result

true：回傳狀態成功｜false：回傳狀態失敗（bool）

message

回傳狀態失敗訊息（string）

data

回傳資料（array[object]）

resultCount

回傳分頁資料筆數（int）

originalCount

回傳非分頁資料筆數（int）

validResult

true：form-data驗證成功｜false：form-data驗證失敗（bool）

validMessage

form-data欄位驗證失敗訊息（string）

StatusCode

回傳狀態碼（int）

fields

form-data欄位驗證失敗訊息（array[object]）

EX：

[
    {
        "Key": "key",
        "Value": {
            "key": "key",
            "name": "API金鑰",
            "value": null,
            "result": false,
            "message": "缺少API金鑰欄位參數"
        }
    }
]

Example Code

• Url Get

curl https://www.db2sys.com.tw/export/{Project_token}/{ProjectUnit_token}/{security_code}/list?type=excel&original=false&skip=0&take=10&sort=age+desc&columns=%5B%22name%22%2C%22age%22%5D&filter=%5B%7B%22key%22%3A%22sex%22%2C%22value%22%3A%221%22%2C%22operator%22%3A%22%3D%22%2C%22logical%22%3A%22%26%26%22%7D%2C%7B%22key%22%3A%22name%22%2C%22value%22%3A%22aa%25%22%2C%22operator%22%3A%22like%22%2C%22logical%22%3A%22%26%26%22%7D%2C%7B%22key%22%3A%22age%22%2C%22value%22%3A%223%22%2C%22operator%22%3A%22%3E%3D%22%2C%22logical%22%3A%22%26%26%22%7D%5D