WIP: Adding initial API documentation
WIP: Adding more API documentation for the Core API

As we release each part, the documentation will
be updated.
switching to `http` highlighting per @warmwaffles recommendation
adding URI Template link and notes
301 redirect instead of an error for non-https
Merge pull request #71 from kissmetrics/nk/api-documentation

Adding Core API Documentation