[DOCS]: Move _reindex API examples to ES reference documentation (#129341)

* Add Reindex indices examples

* Update docs/reference/elasticsearch/rest-apis/reindex-indices.md

Co-authored-by: Liam Thompson <32779855+leemthompo@users.noreply.github.com>

* Update section structure and add TOC

* Add back the TEST snippets

---------

Co-authored-by: Liam Thompson <32779855+leemthompo@users.noreply.github.com>

Author: charlotte-hoblik