justintv / Twitch-API

A home for details about our API
www.twitch.tv
1.72k stars 379 forks source link

Question about get feed/channel/posts request #599

Open burannah opened 8 years ago

burannah commented 8 years ago

Hi!

I am making some request like this: https://api.twitch.tv/kraken/feed/bangbangalang/posts And getting this JSON: {"_total":0,"_cursor":"","_topic":"feeds.channel.104447238","posts":[]} What is the _topic value mean? Also, i think that cursor description here is very obscure. Maybe someone can provide a proper example on how to use it?

freaktechnik commented 8 years ago

It is a property starting with _ which are traditionally "internal" properties that are not documented (except for _link and slowly _id). It seems to me that it is an identifier used for the PubSub system, but it seems that's for internal use for now.

The cursor is a page ID, so to get the next page, you need to request with the cursor to the next page etc. This is instead of specifying the offset from the start.

Lastly such questions about how to use the API are better asked on https://discuss.dev.twitch.tv/c/api, as this is a bugtracker about issues within the documentation, not example board.

burannah commented 8 years ago

Thanks for clarification. I was not asking for an example BTW. I was suggesting to improve it with additional example to make it more user-friendly (It already has lot's of request/response examples as you can see).