Upgrade to Pro — share decks privately, control downloads, hide ads and more …

福利請聽 API

2700fbe9e51dde6e61ee553b60c31153?s=47 Jerry Lee
August 03, 2013
230

福利請聽 API

g0v 福利請聽專案
http://listening-api.g0v.tw

2700fbe9e51dde6e61ee553b60c31153?s=128

Jerry Lee

August 03, 2013
Tweet

Transcript

  1. 福利請聽 API 小蟹 1 13年8月3⽇日星期六

  2. 小蟹 有點資深⼯工程師 Taipei Rails Meetup 協辦 ⻑⾧長期專案 contributor @wildjcrt github.com/wildjcrt

    2 13年8月3⽇日星期六
  3. Agenda • 緣起 - 參加零時政府黑客松 - 參加專案經驗談 • 福利請聽 API

    專案 - 專案初期(第壹次) - 專案現況(第貳次) - API 的開放使用與介紹 • 總結 3 13年8月3⽇日星期六
  4. 緣起 4 13年8月3⽇日星期六

  5. 參加零時政府黑客松 5 13年8月3⽇日星期六

  6. • 想要認識各路強者 • 對政府不甚滿意,想要做點事改變現況 • 於是決定參加第壹次零時政府黑客松 • 然後就發現… 6 13年8月3⽇日星期六

  7. 額滿了…… 7 13年8月3⽇日星期六

  8. 進擊的工程師 8 13年8月3⽇日星期六

  9. • 寫機器人檢查有沒有人取消報名 • 最後…… 9 13年8月3⽇日星期六

  10. 10 個小時前報名成功 10 13年8月3⽇日星期六

  11. 黑客松開始 11 13年8月3⽇日星期六

  12. • 重點一:填寫鄉民列表 ➡ 讓自己可以被專案組長找到 • 重點二:聆聽各專案組長報告 ➡ 尋找自己有興趣的專案 ➡ 不要再問有沒有人做了,你就是那個

    「沒有人」 尋找專案經驗談 12 13年8月3⽇日星期六
  13. 鄉民列表 13 13年8月3⽇日星期六

  14. 三個關鍵字自我介紹 14 13年8月3⽇日星期六

  15. 加入福利請聽 15 13年8月3⽇日星期六

  16. 福利請聽 API 專案 16 13年8月3⽇日星期六

  17. 專案初期(第壹次) 17 13年8月3⽇日星期六

  18. • 討論專案目標 ➡ 限制:黑客松時間 (9AM - 17PM) ➡ 人力:三人 ➡

    目標:篩選法條 ➡ 範圍:僅限高雄市身心障礙法條 • 挑戰 ➡ 法條手動轉 Markdown ➡ 利用 tag 機制篩選法條 • Demo ➡ 使用 git 並發佈到 Heroku 平台 18 13年8月3⽇日星期六
  19. DOWN…… 19 13年8月3⽇日星期六

  20. 專案現況(第貳次) 20 13年8月3⽇日星期六

  21. • 長期專案,繼續黑客松 • 人力:五人 • 目標不變:篩選法條 • 範圍擴大:所有福利法條均可收錄 • 進階篩選:設計三階層式

    tag 架構 • 介面設計:針對想申請福利者而設計 21 13年8月3⽇日星期六
  22. • 做到午餐完,我發現…… • 不會寫 NodeJS 幫不上太大的忙 • 做自己最擅長的事情才能貢獻更多 • 提議:後端的法條部分拆成第二個專案

    ➡ 前端:NodeJS ➡ 後端:Rails ➡ API 格式:JSON 22 13年8月3⽇日星期六
  23. API 的開放使用與說明 23 13年8月3⽇日星期六

  24. • 網站原始碼 - https://github.com/g0v/listening_api • PUBLIC API - 機關 API

    - 法條 API 24 13年8月3⽇日星期六
  25. • 網站原始碼使用 MIT License • 法條是有著作權的,尤其要注意並非政府 網站上的資料都能任意修改、使用 • 將法條轉成 markdown

    是一個重製行為 發現問題:著作權 25 13年8月3⽇日星期六
  26. 免責聲明 • 本專案內所收錄的法條,由福利請聽團隊整理自 各項福利的官網資訊,且福利來源以該單位最新 頒佈為準,本專案之資料僅供參考,若有不正確 之處請來信與我們反應。 • 此外,針對收錄之內容沒有任何相關領域的專家 和專業人員再對內容的完善性、正確性或可靠性 進行驗證,故本專案不保證其內容正確無誤。

    • 本專案也未作出任何明示或默示的擔保。任何使 用本專案之人士,須自行承擔一切風險,本專案 不會負責任何因使用、重製或散布內容而引致之 損失。 特別感謝 ant / legist 協助 26 13年8月3⽇日星期六
  27. 機關 API http://listening-api.g0v.tw/public/orgs.json http://listening-api.g0v.tw/public/orgs/:eng_name.json http://listening-api.g0v.tw/public/orgs/KHH.json 27 13年8月3⽇日星期六

  28. 機關 JSON 28 13年8月3⽇日星期六

  29. 法條 API http://listening-api.g0v.tw/public/orgs/:eng_name/rules.json http://listening-api.g0v.tw/public/orgs/:eng_name/rules/:id.json http://listening-api.g0v.tw/public/orgs/KHH/rules/1.json 或是 http://listening-api.g0v.tw/public/rules/:id.json http://listening-api.g0v.tw/public/rules/1.json 29 13年8月3⽇日星期六

  30. 法條 JSON 30 13年8月3⽇日星期六

  31. 範例:AJAX $.ajax({ type: "GET", url: 'http://listening-api.g0v.tw/public/orgs/KHH/rules/1', dataType: 'jsonp' }).success(function(data){ console.log(data);

    }); 31 13年8月3⽇日星期六
  32. 範例:curl $ curl ‘http://listening-api.g0v.tw/public/orgs/KHH/rules/1.json’ 32 13年8月3⽇日星期六

  33. 總結 33 13年8月3⽇日星期六

  34. • 做自己最擅長的事很輕鬆 • 做自己喜歡的事很快樂 • 可以幫助到更多需要幫助的人 • 不需要艱深的技術力就可以有貢獻 34 13年8月3⽇日星期六

  35. • 不只是由你/我完成。 • 讓每個人在各自專長的地方貢獻一點點, 並且都由此受益。 零時政府 & 福利請聽 共同理念 35

    13年8月3⽇日星期六
  36. ➡ 設計:美化網站 ➡ 前端:UI & UX 、 NodeJS ➡ 文案:法條轉換(10分鐘上手)

    ➡ 後端:三階層式 tag 實作、Rails 我們需要你/妳 36 13年8月3⽇日星期六
  37. 不用想、不用害羞 做就對了 37 13年8月3⽇日星期六

  38. 感謝參與過專案的所有人 38 13年8月3⽇日星期六

  39. 第肆次國民大會黑客松 文字 08/10 09:00 ~ 18:00 39 13年8月3⽇日星期六

  40. THANK YOU. 40 13年8月3⽇日星期六

  41. Q & A 41 13年8月3⽇日星期六