Added instructions for authentication

Author: Tom Schenk Jr

docs/api.md

@@ -1,13 +1,39 @@
 # API Documentation
 
 ## Submitting Patient Record
- 
-Submit a patient record and retrieve the estimated risk of having elevated blood-lead levels.
+
+### Authentication
+
+Submitting patient records to Lead Safe requires client credentials to retrieve a token, which is required for all API calls. City of Chicago will issue a client ID and a client secret ID which will be used to obtain a token.
+
+
+```bash
+GET --user CLIENT_ID:CLIENT_SECRET --data "grant_type=client_credentials" <url>/oauth/token
+```
+
+Successful requests for a token will return a JSON file similar to this:
+
+```json
+{"access_token":"TOKEN","token_type":"bearer","expires_in":3600}
+```
+
+Tokens are set to expire every 3,600 seconds (1 hour) and a new token will need to be obtained.
+
+To upload a patient record, the POST command must include a header called `Authorization: Bearer` followed by the TOKEN obtained in the previous steps.
+
+An upload would look like:
 
 ```bash
-POST {json file} <url>/insert/
+POST --header "Content-Type:application/json" --header "Authorization: Bearer TOKEN" FILE.JSON <url>/upload/insert/
 ```
 
+The format for `FILE.JSON` is described in the next section.
+
+### Schema
+ 
+Submit a patient record and retrieve the estimated risk of having elevated blood-lead levels.
+
+
 | Field           | Format   | Constraints                        | Notes                                                                                                             |
 |-----------------|----------|------------------------------------|-------------------------------------------------------------------------------------------------------------------|
 | timestamp       | TimeDate | yyyy-mm-dd hh:mm:ss.sss-hh:mm      | Current timestamp (RFC 3339 compliant date)                                                                       |

mkdocs.yml

@@ -1,6 +1,6 @@
 
 # Site Information
-site_name: Lead Safe API v0.6.0
+site_name: Lead Safe API v1.0.0-rc.1
 site_author: City of Chicago
 site_description: Lead Free API Documentation
 site_url: http://dev.cityofchicago.org/docs/lead-free
@@ -19,7 +19,7 @@ pages:
 - 'Terms of Service': 'tos.md'
 
 # Copyright
-copyright: Copyright &copy; 2016-2017 <a href="http://www.cityofchicago.org">City of Chicago</a> and licensed under <a href="http://creativecommons.org/licenses/by-sa/4.0/">Creative Commons Attribution-ShareAlike 4.0 International</a>.
+copyright: Copyright &copy; 2016-2018 <a href="http://www.cityofchicago.org">City of Chicago</a> and licensed under <a href="http://creativecommons.org/licenses/by-sa/4.0/">Creative Commons Attribution-ShareAlike 4.0 International</a>.
 
 # Repository Information
 # repo_name: Chicago/open311-api-docs