SOLR-16761: Document the bin/solr api command

[epugh]

https://issues.apache.org/jira/browse/SOLR-16761

Description

I didn't know it existed..

Solution

Bit o' docs.

Tests

Please describe the tests you've developed or run to confirm this patch implements the feature or solves the problem.

Checklist

Please review the following and check all that apply:

• I have reviewed the guidelines for How to Contribute and my code conforms to the standards described there to the best of my ability.
• I have created a Jira issue and added the issue ID to my pull request title.
• I have given Solr maintainers access to contribute to my PR branch. (optional but recommended)
• I have developed this patch against the main branch.
• I have run ./gradlew check.
• I have added tests for my changes.
• I have added documentation for the Reference Guide

[epugh]

As I opened this PR I wondered to myself, why do we have this command? Why not just use Curl etc? I'm curious if we have any ideas why this is here? For situations where you don't have curl???

[HoustonPutman]

As I opened this PR I wondered to myself, why do we have this command? Why not just use Curl etc? I'm curious if we have any ideas why this is here? For situations where you don't have curl???

There are a couple issues, like basicAuth and TLS I believe, that this makes much easier. (Though I have seen the command take extraordinary amounts of time to run. Like 5 seconds for a basic check that should take milliseconds)

[HoustonPutman]

Suggested change

	=== Improvements to Solr CLI
	* the bin/solr -i and bin/solr -info removed in favour of bin/solr status command.
	=== Improvements to the Solr CLI
	* The`-i` and `-info` options for `bin/solr` have been removed in favour of the `bin/solr status` command.

I think you added this to the wrong PR though...

[epugh]

argh.... How about I must merge this one ;-)