#29742 apitoken doc IQA fixes & more

[jdcmsd]

This addresses everything raised in this IQA doc, and then further issues I found while working on that initial batch. I won't go point by point on this in the bullets below, because it's quite a lot and I've completely lost track of them all. But I'll list the biggest ones I can remember.

Proposed Changes

• All concerns in document addressed
• Both forms edited
  • ApiTokenForm got a couple of @Hidden annotations for unnecessary props
  • RemoteApiTokenForm had a bunch of variables renamed so error messages make more sense if a key property is omitted.
• Both user-based revocation endpoints have been @Hidden, as neither of them appears to work.
  • (Also found another unrelated bug in the API token UI; separate issue forthcoming. )
    • EDIT: Unable to delete API tokens via UI #30268 is the issue, and it turns out not to be unrelated at all. Removing unnecessary @Consumes annotations fixes it, so the current PR will resolve it. Shoutout to @valentinogiardino for his sharp eye!
• Various text fixes
• Various schema fixes
• Various response example fixes
• Several endpoint descriptions corrected
• Various request body description and/or example fixes
• Tag adjustment

Checklist

• Tests
• Translations
• Security Implications Contemplated (add notes if applicable)

This PR fixes: #29742

[dotcms-sonarqube]

Quality Gate passed

Issues
4 New issues
2 Fixed issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube