Scope should be better documented

For one thing, there is no example of what the URL should look like. It is not clear what the default scopes are, nor how to use multiple scopes in a URL.

Yet if I try to have an URL with:

&scope=identity, identity.memberships
&scope=identity identity.memberships

I get an error page immediately. (Missing data)

Furthermore, I cannot seem to be able to find a complete list of the available scopes.

More specific to my issue, I am trying to obtain the currently_entitled_tiers of the user who just link their account to my server. There is no clear example on how to do this, despite being a fairly common task I imagine.

Querying https://www.patreon.com/api/oauth2/v2/identity works just fine, but only returns me the user.id, but querying https://www.patreon.com/api/oauth2/v2/members/${userId} returns me an authentication error or, more recently, a timeout. Given both requests are essentially a copy/paste, all I can think of is that I don’t have the scope… which the error message should hint at but does not.

Hope this is constructive feedback!

1 Like