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).