Update docstrings and methods in api.py.

Update the references URL in the doctring with the new Twitter API doc.
Fix formatting for :allowed_param in the docstring.
Fix method for destroy endpoints (POST instead of DELETE).
Merge pull request #485 from volnt/patch-1

Update docstrings and methods in api.py.