serhiy-bzhezytskyy opened a new pull request, #5123: URL: https://github.com/apache/solr/pull/5123
https://issues.apache.org/jira/browse/SOLR-18499 # Description The v2 API page presents `_introspect` as the way the API documents itself. On a running node `_introspect` answers only for the endpoints still on the old v2 framework (`/api/cluster` lists only `set-ratelimiter`, `/api/node` only `overseer-op`); for the JAX-RS endpoints that replace them, such as `/api/cluster/nodes` or `/api/cluster/properties`, it returns 404. The page's cluster example, `{ set-property: ... }` posted to `/api/cluster`, is rejected with `Error in command payload`. # Solution The Introspect sections and the "self-documenting" claims are removed. In the path table `/api/cluster` now lists what it accepts, with `/api/cluster/nodes` and `/api/cluster/properties` as separate rows, and the cluster property example uses `PUT /api/cluster/properties/{name}`. Written with Claude Code. # Tests The replacement example returns status 0 and the property shows up in `GET /api/cluster/properties`. `buildLocalAntoraSite` and `checkSiteLinks` pass. # Checklist - [x] I have reviewed the guidelines for [How to Contribute](https://github.com/apache/solr/blob/main/CONTRIBUTING.md) and my code conforms to the standards described there to the best of my ability. - [x] I have created a Jira issue and added the issue ID to my pull request title. - [x] I have given Solr maintainers [access](https://help.github.com/en/articles/allowing-changes-to-a-pull-request-branch-created-from-a-fork) to contribute to my PR branch. (optional but recommended, not available for branches on forks living under an organisation) - [x] I have developed this patch against the `main` branch. - [ ] I have run `./gradlew check`. - [ ] I have added tests for my changes. - [x] I have added documentation for the [Reference Guide](https://github.com/apache/solr/tree/main/solr/solr-ref-guide) - [ ] I have added a [changelog entry](https://github.com/apache/solr/blob/main/dev-docs/changelog.adoc) for my change -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
