福利請聽 API

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

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⽇日星期六