core-documentation

Question of ASK

List questions

GET /ask/questions

Auth

NO

persona_speeches需要是“citizen” AND “self”

Paging

YES

Available query parameters

Key Type Description Match Example
game string 用game slug過濾問題清單 exact 2018-taipei
q string 用關鍵字過濾問題清單 [1] exact 殭屍
topics array of integers: topic IDs 用議題過濾問題清單 任一即可 [1, 2, 3]
statuses array of strings: statuses [2] 用「狀態」過濾問題清單 任一即可 ["keep_pushing", "expect_answers"]
personas array of integers: persona IDs 用提問者的persona過濾答案清單 任一即可 [1, 2, 3]
me_pushed integer 是否有被active_persona連署？ exact 1
assigned_to integer: persona ID 某persona是否有被指定回答？ exact 42
answered_by integer: persona ID 是否有被某個persona回答？ exact 42
answered integer 是否有被任意一個persona回答？ exact 1
order_by string [3] 問題排序 exact start_date

[1]

搜尋範圍：ASK_Question.title, ASK_Question.content, ASK_Question.references

[2]

可能的string：keep_pushing、expect_answers、failed

all_targets = all Persona_Speech_Target
targets = all_targets.filter(target =>
  target.source_entity === 'ASK_Question' &&
  target.source_id === question.id &&
  target.sp_type === 'ask_question_push'
)
assert(targets.length === 1) // 一定有一個，且只有一個符合條件的target
question.target = targets[0]

keep_pushing

Now.time <= Question.target.end_date

expect_answers

Question.push.count >= Question.data.threshold

failed

Now.time > Question.target.end_date && Question.push.count < Question.data.threshold

[3]

可能的string：start_date、push_count

Response

{
  rows: [
    {
      id
      status
      slug
      type
      persona: {} // 與GET /persona格式相同
      game: {} // 與GET /ask/games中的Game object格式相同
      index
      topic_type
      topic_id
      image
      title
      content
      references: [
        {}
        ...
      ]
      chatroom_id
      data: {}
      assigned_personas: [ // [1]
        *personaObject*
        ...
      ]
      persona_speech_targets: [ // [2]
        {
          id
          type
          source_entity
          source_id
          sp_type
          sp_per_persona
          start_date
          end_date
          data: {}
        }
        ...
      ]
      persona_speeches: [ // [3]
        {
          id
          target_id
          date
          type
          content
          data: {}
        }
        ...
      ]
      push: {
        count // [4]
      }
      answers: [
        {} // 完整的answerObject
        ...
      ]
    }
    ...
  ]
  totalRowCount
  paging: {
    page
    pages
    pageSize
    previous
    next
  }
}

[1]

From ASK_Question_Assigned_Persona

[2]

以這個Q為source的Persona_Speech_Target列表

[3]

以目前active persona為發言人，以[2]所列任一Persona_Speech_Target為target的Persona_Speech列表；權限不足則無此項目

[4]

計算以[2]所列target中任一為target，且type是ask_question_push的Persona_Speech數量，也就是這個Q的連署人數

Get a single question

GET /ask/questions/:id

Auth

NO

persona_speeches需要是“citizen” AND “self”；權限不足則無此項目

Paging

NO

Response

與List questions中的Question object格式相同

Create a question

POST /ask/questions

Auth

Paging

NO

Input

Key Type Required Description
type string 🌑 問題類型
game integer 🌕 此問題所屬的game ID
topic integer 🌕 與此問題相關連的topic ID
image string 🌑 此問題的封面圖片連結
title string 🌕 此問題的標題
content string 🌑 此問題的內容
references JSON 🌑 此問題的參考資料
data JSON 🌑 此問題的其他資訊
assigned_personas array of integers: persona IDs 🌑 指定回答此問題的persona ID列表

Sample input

{
  "type": "default",
  "game": 1,
  "topic": 1,
  "image": "https://i.waa.tw/gUYUdY.png",
  "title": "青年失業問題該如何解決？",
  "content": "據主計處2017年7月份統計資料20-24歲青年失業率高達14.67%，也就代表每8個年輕人就有1位是屬失業狀態的。人力銀行分析其原因，主要為二：台灣的低薪環境、勞動環境惡劣；若再將30歲以下失業率計算進去，總數超過20萬人，比例已占全台近半失業率，這難道不是政府與企業該重視的警訊嗎？",
  "assigned_personas": [1, 2, 3]
}

Push a question

POST /ask/questions/:id/push

Auth

Paging

NO

Response

與Get a single question中的Question object格式相同

Speech target missing

{
  "statusCode": 400,
  "error": "Bad Request",
  "message": "SPEECH_TARGET_MISSING"
}

Push limit exceeded

{
  "statusCode": 400,
  "error": "Bad Request",
  "message": "PUSH_LIMIT_EXCEEDED"
}