If I do something like:
https://api.twitch.tv/kraken/channels/steven_bonnell_ii/subscriptions/1337hephaestus
I would expect to have to provide the :user's token and get a response indicating whether or not I was subscribed to Destiny.
However, the subscriptions resource now works more like a subscribers resource, in that it depends on the :channel's auth token, and tells the channel whether or not a user is a subscriber, (or at the root resource, lists the subscribers of a particular channel).
If this is the intended behavior of this resource, then the docs don't make it very clear
eg: 'Check if user is subscribed to channel'
with
curl -i https://api.twitch.tv/kraken/channels/hebo/subscriptions/testuser
could return
'testuser has no subscriptions to hebo'
but it's not obvious that we actually need hebo's token to check if testuser is a sub
image if both testuser and hebo have a sub button, and hebo was subscribed to testuser
which path would give us an error, and which path would identify that hebo is in fact subbed to testuser? And who's token do we need to use? As of now, it's not very clear.
https://api.twitch.tv/kraken/channels/hebo/subscriptions/testuser
https://api.twitch.tv/kraken/channels/testuser/subscriptions/hebo
https://api.twitch.tv/kraken/channels/testuser/subscriptions/hebo
with testuser's auth token would be the only way to find out if hebo is subscribed to testuser
my suggestion:
either clarify the docs to indicate the auth direction and the intent of the system, or allow users to reveal who they are subscribed to
for example:
https://api.twitch.tv/kraken/users/1337hephaestus/subscriptions
could list who I am subscribed to, and
https://api.twitch.tv/kraken/users/1337hephaestus/subscriptions/steven_bonnell_ii
would tell me if I am subscribed to Destiny
OR change the current subscriptions resource to subscribers because it makes more semantic sense given the auth direction
something like
https://api.twitch.tv/kraken/users/1337hephaestus/follows/channels/gomtv
would make sense
e.g.:
https://api.twitch.tv/kraken/users/1337hephaestus/subscribes/channels/gomtv
https://api.twitch.tv/kraken/users/1337hephaestus/subscribes/channels
https://api.twitch.tv/kraken/streams/subscribed
could also be a thing (like /streams/followed)