docs: /warden/allowed do not fully specify security parameters

[bhearsum]

On http://docs.hydra13.apiary.io/#reference/warden/wardenallowed/check-if-a-subject-is-allowed-to-do-something the text description for the endpoint says:

Checks if an arbitrary subject is allowed to perform an action on a resource. This endpoint requires a subject, a resource name, an action name and a context.If the subject is not allowed to perform the action on the resource, this endpoint returns a 200 response with

From this, I can see that the endpoint must be provided the subject, resource, action, and context. However, it's not clear what these parameters should be called. Some of the examples use "action" and "subject", but there is nothing that shows exactly what all of the parameters are named, and what they look like.

[aeneasr]

Unfortunately, this is due to bad design choices by apiary, oauth2 is properly referenced as you can see in the screenshot:

I will try to follow up with apiary on this, which might take some time.

Also, for some reason, it says implicit OAuth2 which isn't correct.

[bhearsum]

Hm, I'm not sure I understand what you mean. Even if I click "oauth2" I don't see any thing about subject, action, etc. It's also not in the Body section of the console, eg: https://screenshots.firefox.com/mAe0p0DKGJeqzZcA/docs.hydra13.apiary.io.

[aeneasr]

That's what I meant that it's a bug in Apiary (the api docs provider) :)

…

Am 31.07.2017 um 15:00 schrieb Ben Hearsum ***@***.***>: Hm, I'm not sure I understand what you mean. Even if I click "oauth2" I don't see any thing about subject, action, etc. It's also not in the Body section of the console, eg: https://screenshots.firefox.com/mAe0p0DKGJeqzZcA/docs.hydra13.apiary.io. — You are receiving this because you were assigned. Reply to this email directly, view it on GitHub, or mute the thread.

[aeneasr]

this has now moved and is no longer an issue