core-documentation

Bill Data Sets

• List bill data sets
• Get a single bill data set
• Create a bill data set
• Update a bill data set
• Delete a bill data set

List bill data sets

GET /console/lab/bill_data_sets

Auth

• “editor”

Paging

NO

Available query parameters

Key	Type	Description	Match	Example
name	string	用名稱過濾提案資料集	partial	罷 罷免
term	integer: term index	用屆期過濾提案資料集	exact	8 9
st	integer: specific topic ID	用關聯小議題過濾提案資料集	exact	1 2
act	integer: act ID	用法案過濾提案資料集	exact	1 2
act_dir	integer: act dir ID	用修法方向過濾提案資料集	exact	1 2

Response

{
  rows: [
    {
      id
      name
      version_no
      slug
      term_index
      start_date
      end_date
      st: {
        id
        title
        image
        index
      }
      act: {
        id
        title
        official_seq_no
      }
      act_dir: {
        id
        name
      }
    }
    ...
  ]
  totalRowCount
}

Get a single bill data set

GET /console/lab/bill_data_sets/:id

Auth

• “editor”

Paging

NO

Response

{
  id
  name
  version_no
  slug
  term_index
  start_date
  end_date
  st_id
  act_id
  act_dir_id
  act_feature_ids: [
    id
    ...
  ]
  bill_ids: [
    id
    ...
  ]
  scores: [] // JSON
}

Create a bill data set

POST /console/lab/bill_data_set

Auth

• “editor”

Paging

NO

Input

Key	Type	Required	Description
name	string	🌕	名稱
version_no	string	🌕	版本號
slug	string	🌑	短網址
term_index	integer	🌕	屆期
start_date	timestamp	🌕	起始日
end_date	timestamp	🌕	終止日
st_id	integer	🌕	關聯小議題 ID
act_id	integer	🌕	關聯法案 ID
act_dir_id	integer	🌕	關聯修法方向 ID
act_feature_ids	array of integers: act feature IDs	🌕	關聯法案比較 ID 列表
bill_ids	array of integers: bill IDs	🌕	委員提案 ID 列表
scores [1]	array of objects	🌕	提案各項評分

[1]

Key	Type	Required	Description
bill_id	Integer	🌕	委員提案 ID
score_per_act_feature [2]	array of objects	🌕	此提案於各個法案比較項目之評分

[2]

Key	Type	Required	Description
act_feature_id	Integer	🌕	法案比較項目 ID
score	Integer	🌕	評分

Sample input

{
  "name": "罷免､第九屆",
  "version_no": "1.0.0",
  "slug": "a/b/c",
  "term_index": 9,
  "start_date": "2016-02-01T00:00:00",
  "end_date": "2020-01-31T00:00:00",
  "st_id": 1,
  "act_id": 1,
  "act_dir_id": 2,
  "act_feature_ids": [1, 2, 3],
  "bill_ids": [21, 29, 33, 36],
  "scores": [
    {
      "bill_id": 21,
      "score_per_act_feature": [
        {
          "act_feature_id": 3,
          "score": 1
        }
      ]
    }
  ]
}

Response

Returns the newly created bill data set

Update a bill data set

PATCH /console/lab/bill_data_set/:id

Auth

• “editor”

Paging

NO

參考 Create a bill data set

Delete a bill data set

DELETE /console/lab/bill_data_set/:id

Auth

• “editor”

Paging

NO

Response

204 No Content