CMR-9706: initial update to documentation

[jceaser]

Overview

Authorization Documentation Cleanup

Clean up the documentation around the token URL parameter and the Authorization header

What is the Solution?

1. To mark the token parameter as deprecated and to provide a link to the authorization header section.
2. Clean up the authorization header section
3. General cleanup of the header section
4. Adding some undocumented headers

What areas of the application does this impact?

api.md documentation of search

Checklist

• [-] I have updated/added unit and integration tests that prove my fix is effective or that my feature works
• [-] New and existing unit and int tests pass locally and remotely with my changes
• [-] I have removed unnecessary/dead code and imports in files I have changed
• [x] I have performed a self-review of my own code
• [-] I have commented my code, particularly in hard-to-understand areas
• [x] I have made corresponding changes to the documentation
• [-] My changes generate no new warnings
• [-] I have cleaned up integration tests by doing one or more of the following:
  • de-duped, consolidated, removed dead int tests
  • transformed applicable int tests into unit tests
  • refactored to reduce number of system state resets by updating fixtures (use-fixtures :each (ingest/reset-fixture {})) to be :once instead of :each