Rights check on RetrieveCorpus

Closes #1101 (closed)

• Rewrote the API description
• Added help_text on fields whose meanings are non-trivial
• Fixed two RuntimeWarnings related to missing timezones on datetimes during unit test execution
• Added missing unit tests