core-documentation

Speech

• List speeches
• Get a single persona speech
• Create a persona speech

List speeches

GET /persona/speeches

Auth

• “citizen” AND “self”

Paging

NO

Available query parameters

Key	Type	Description	Match	Example
target_source_entity	string: table name	用speech target source entity name過濾草民言論清單；Source entity是指Persona_Speech_Target.source_entity	exact	Poll Article
target_source_id	integer: id to table referenced by target_source_entity	用speech target source ID過濾草民言論清單；Source ID是指Persona_Speech_Target.source_id，傳入值必須是整數，並與target_source_entity所指table的key的格式相符	exact	1 2

解釋

• GET /persona/speeches?target_source_entity=Poll&target_source_id=1
  • → 目前Persona對ID為1的Poll所發表的所有言論

Response

{
  rows: [
    {
      id
      persona_speech_target: {
        id
        type
        source_entity
        source_id
        sp_type
        sp_per_persona
        start_date
        end_date
        data: {}
      }
      date
      type
      content
    }
    ...
  ]
  totalRowCount
}

Get a single persona speech

GET /persona/speeches/:id

Auth

• “citizen” AND “self”

Paging

NO

Create a persona speech

POST /persona/speeches

Auth

• “citizen” AND “self”

Paging

NO

Input

Key	Type	Description
persona_speech_target_id	integer: persona speech target ID	persona speech target ID
type	string	言論類型
content	string	言論內容
data	object	資料

言論類型與內容、資料格式規範

ballot

• content為姓名的字串
• data為NULL

ask_question_push

• content為1的數字字串
• data為NULL

ask_answer_review

• content為1-5的數字字串
• data為NULL

musou_line_chart_response

• content為NULL
• data為response data object，格式如下

格式待補

Sample input

{
  "persona_speech_target_id": 1,
  "type": "ballot",
  "content": "黃培閎"
}

Response

Returns the newly created persona speech