Merge pull request #2779 from atom/document-atom-io-pagination

Document pagination for atom.io/api/packages
This commit is contained in:
Kevin Sawicki
2014-07-22 08:44:48 -07:00

View File

@@ -27,6 +27,10 @@ All requests that take parameters require `application/json`.
#### GET /api/packages
Parameters:
- **page** (optional)
Returns a list of all packages in the following format:
```json
[
@@ -44,6 +48,15 @@ Returns a list of all packages in the following format:
]
```
Results are paginated 30 at a time, and links to the next and last pages are
provided in the `Link` header:
```
Link: <https://www.atom.io/api/packages?page=1>; rel="self",
<https://www.atom.io/api/packages?page=41>; rel="last",
<https://www.atom.io/api/packages?page=2>; rel="next"
```
### Showing package details
#### GET /api/packages/:package_name