doc: clarified validate param 'name'

Made it clear(er) the the user/programmer needs to add the name param in case name and id are unequal.
Merge pull request #624 from ArthurClemens/patch-4

doc: clarified validate param 'name'
doc: added example call for retrieving actual stats

Also aligned example code with described data structure: renamed 'example' to 'something'.
Merge pull request #625 from ArthurClemens/patch-5

doc: added example call for retrieving actual stats