Merge pull request #44 from SparkPost/ISSUE-3

Add sphinx doc for metrics.

Author: richleland

docs/index.rst

@@ -33,7 +33,7 @@ Alternatively, you can pass the API key to the SparkPost class:
     from sparkpost import SparkPost
     sp = SparkPost('YOUR API KEY')
     
-.. _API & SMTP: https://app.sparkpost.com/#/configuration/credentials
+.. _API & SMTP: https://app.sparkpost.com/configuration/credentials
 
 
 Resources
@@ -44,6 +44,7 @@ The following resources are available in python-sparkpost:
 .. toctree::
     :maxdepth: 1
 
+    resources/metrics
     resources/transmissions
 
 
@@ -63,7 +64,7 @@ Additional documentation
 
 The underlying SparkPost API is documented at the official `SparkPost API Reference`_.
 
-.. _SparkPost API Reference: https://www.sparkpost.com/docs/introduction
+.. _SparkPost API Reference: https://www.sparkpost.com/api
 
 
 Contribute
@@ -74,6 +75,6 @@ Contribute
 #. Write a test which shows that the bug was fixed or that the feature works as expected.
 #. Send a pull request. Make sure to add yourself to AUTHORS_.
 
-.. _`the repository`: http://github.com/richleland/python-sparkpost
-.. _AUTHORS: https://github.com/richleland/python-sparkpost/blob/master/AUTHORS.rst
+.. _`the repository`: http://github.com/SparkPost/python-sparkpost
+.. _AUTHORS: https://github.com/SparkPost/python-sparkpost/blob/master/AUTHORS.rst
 

docs/resources/metrics.rst

@@ -0,0 +1,34 @@
+Metrics
+=======
+
+Retrieve a list of campaigns
+----------------------------
+
+.. code-block:: python
+
+    from sparkpost import SparkPost
+
+    sp = SparkPost()
+
+    sp.metrics.campaigns.list()
+
+
+Retrieve a list of domains
+--------------------------
+
+.. code-block:: python
+
+    from sparkpost import SparkPost
+
+    sp = SparkPost()
+
+    sp.metrics.domains.list()
+
+
+Additional documentation
+------------------------
+
+See the `SparkPost Metrics API Reference`_.
+
+.. _SparkPost Metrics API Reference: https://www.sparkpost.com/api#/reference/metrics
+

docs/resources/transmissions.rst

@@ -21,7 +21,7 @@ Here at SparkPost, our messages are known as transmissions. Let's use the underl
     print response
     # outputs {u'total_accepted_recipients': 1, u'id': u'47960765679942446', u'total_rejected_recipients': 0}
 
-.. _transmissions API: http://www.sparkpost.com/docs/transmissions-api
+.. _transmissions API: https://www.sparkpost.com/api#/reference/transmissions
 
 
 Send a transmission
@@ -119,13 +119,13 @@ Further examples
 
 See the `python-sparkpost transmissions examples`_.
 
-.. _python-sparkpost transmissions examples: https://github.com/richleland/python-sparkpost/tree/master/examples/transmissions
+.. _python-sparkpost transmissions examples: https://github.com/SparkPost/python-sparkpost/tree/master/examples/transmissions
 
 
 Additional documentation
 ------------------------
 
 See the `SparkPost Transmissions API Reference`_.
 
-.. _SparkPost Transmissions API Reference: https://www.sparkpost.com/docs/transmissions-api
+.. _SparkPost Transmissions API Reference: https://www.sparkpost.com/api#/reference/transmissions