DOC: add Timestamp / Period / Interval to api.rst
should document the pandas scalars in api.rst

xref https://github.com/pandas-dev/pandas/pull/17331#discussion_r135783580

- [ ] ``Timestamp``
- [ ] ``Timedelta``
- [ ] ``Period``
- [ ] ``Interval``