link docs!

This commit is contained in:
Kenneth Reitz
2012-08-21 00:52:09 +10:00
parent 3514816d63
commit 49a7947bcb
+7 -6
View File
@@ -534,13 +534,14 @@ GitHub uses these for `pagination <http://developer.github.com/v3/#pagination>`_
>>> url = 'https://api.github.com/users/kennethreitz/repos?page=1&per_page=10'
>>> r = requests.head(url=url)
>>> print r.headers['link']
...
'x-ratelimit-remaining': '4995'
'x-ratelimit-limit': '5000'
...
>>> r.headers['link']
'<https://api.github.com/users/kennethreitz/repos?page=2&per_page=10>; rel="next", <https://api.github.com/users/kennethreitz/repos?page=6&per_page=10>; rel="last"'
Requests will automatically parse these link headers and make them easily consumable:
Requests will automatically parse these link headers and make them easily consumable::
>>> r.links['next']
'https://api.github.com/users/kennethreitz/repos?page=2&per_page=10'
>>> r.links['last']
'https://api.github.com/users/kennethreitz/repos?page=6&per_page=10'