API-IN-A-BOX a containerized hypermedia approach to civic hacking by Shelby Switzer

Transcript

1. API-IN-A-BOX API-IN-A-BOX @switzerly shelbyswitzer.com getnotion.com a containerized hypermedia approach to civic hacking
2. THE WORLD RUNS ON SMALL DATA. THE WORLD RUNS ON SMALL DATA.
4. SHOW-ME-THE-FOOD SHOW-ME-THE-FOOD identify food deserts add canvassing tool visualize findings change the world
6. THE NEED: THE NEED: easy (and free) way to store and maintain data little or no changes to raw data has or can integrate with flexible, robust API does not need to be hosted simple setup locally or on any server
9. { "business" : { "name" : "Hairy Convenience", "lat" : "33.760094", "lng" : "-84.386037", "bustype" : "convenience" } } document: mapping: { "business" : { "properties" : { "name" : { "type" : "string" }, "lat" : { "type" : "string" }, "lng" : { "type" : "string" }, "bustype" : { "type" : "string" }, "FILE_SOURCE": { "type": "string"}, } } }
10. THE NEED: THE NEED: easy (and free) way to store and maintain data little or no changes to raw data has or can integrate with flexible, robust API does not need to be hosted simple setup locally or on any server
12. { "collection" : "href" : "http://dockerip:4567/resources/", "items" : [ { "href" : "http://dockerip:4567/resources/8903493", "data" : [ {"name" : "name", "value" : "Bob's Convenience Store"}, {"name" : "lat", "value" : "33.760094"}, {"name" : "lng", "value" : "-84.386037"}, {"name" : "bustype", "value" : "convenience"}, {"name" : "FILE_SOURCE", "value" : "GA_EBT.csv"} ] } ], "queries" : [ {"rel":"search", "href":"http://dockerip:4567/resources/search", "prompt":"Search", "data" : [ {"name" : "name", "value" : ""}, {"name" : "lat", "value" : ""}, {"name" : "lng", "value" : ""}, {"name" : "bustype", "value" : ""}, {"name" : "FILE_SOURCE", "value": ""}, {"name" : "dedupe", "value" : ""} ] } ] } HYPERMEDIA: COLLECTION+JSON HYPERMEDIA: COLLECTION+JSON
13. THE NEED: THE NEED: easy (and free) way to store and maintain data little or no changes to raw data has or can integrate with flexible, robust API does not need to be hosted simple setup locally or on any server
15. API API
16. api: build: ./api command: bash ./deploy/start.sh volumes: - api:/api ports: - "4567:4567" links: - elastic elastic: image: dockerfile/elasticsearch ports: - "9200:9200" - "9300:9300" volumes: - docker_volumes/elasticsearch_data:/usr/local/elasticsearch/data docker-compose.yml
17. $ docker-compose up -e ORIGIN_REPO="switzersc/food-data" $ curl http://dockerip:4567/resources?dedupe=bustype 1. throw data into github repo 2. pull/build docker image 3. 4. API-IN-A-BOX API-IN-A-BOX
18. THE NEED: THE NEED: easy (and free) to store and maintain data little or no changes to raw data has or can integrate with flexible, robust API does not need to be hosted simple setup locally or on any server
19. GET INVOLVED! GET INVOLVED! https://github.com/switzersc/api-in-a-box http://www.codeforamerica.org/brigade/
20. THANKS! THANKS! @switzerly shelbyswitzer.com getnotion.com
21. https://github.com/switzersc/api-in-a-box https://hub.docker.com/r/switzersc/api-in-a-box/ http://www.elastic.co/guide/en/elasticsearch/guide/current /index.html http://amundsen.com/media-types/collection/ https://www.data.gov/developers/apis RESOURCES RESOURCES