Fix the security check when a wrong permission is specified [9.x.x]

[mauritsvanrees]

Backport of PR #2042 for Plone 6.1 and earlier.

And update the http-examples in the documentation to be correct for Plone 6.1.

Note that the lint check may fail because pyupgrade wants to remove these lines from setup.py:

-if sys.version_info.major == 2:
-    raise ValueError(
-        "plone.restapi 10 requires Python 3. "
-        "Please downgrade to plone.restapi 7 for Python 2 and Plone 4.3/5.1."
-    )
-
-

And afterwards flake8 then complains:

setup.py:5:1: F401 'sys' imported but unused

I think we want to keep those lines on this 9.x.x branch.

[mister-roboto]

@mauritsvanrees thanks for creating this Pull Request and helping to improve Plone!

TL;DR: Finish pushing changes, pass all other checks, then paste a comment:

@jenkins-plone-org please run jobs

To ensure that these changes do not break other parts of Plone, the Plone test suite matrix needs to pass, but it takes 30-60 min. Other CI checks are usually much faster and the Plone Jenkins resources are limited, so when done pushing changes and all other checks pass either start all Jenkins PR jobs yourself, or simply add the comment above in this PR to start all the jobs automatically.

Happy hacking!

[mauritsvanrees]

For good measure I am testing this together with the similar plone/plone.autoform#94 on Jenkins.

[read-the-docs-community]

Documentation build overview

📚 plone.restapi | 🛠️ Build #34310700 | 📁 Comparing 6cf4de1 against latest (ee96ad9)

  🔍 Preview build  

23 files changed · ± 22 modified · - 1 deleted

± Modified

• index.html
• upgrade-guide.html
• contributing/index.html
• endpoints/aliases.html
• endpoints/controlpanels.html
• endpoints/index.html
• endpoints/querystringsearch.html
• endpoints/registry.html
• endpoints/searching.html
• endpoints/site.html
• and 12 more...

- Deleted

• usage/parameters.html