mirror of
https://github.com/wahyd4/gitlabhq.git
synced 2026-08-11 13:46:11 +10:00
The notes API documentation updated with return codes. API now returns `400 Bad Request` if required attributes are not present. Return codes are documented now, also tested in added tests. The documentation now reflects the current state of the API.
GitLab API
All API requests require authentication. You need to pass a private_token parameter by url or header. You can find or reset your private token in your profile.
If no, or an invalid, private_token is provided then an error message will be returned with status code 401:
{
"message": "401 Unauthorized"
}
API requests should be prefixed with api and the API version. The API version is defined in lib/api.rb.
Example of a valid API request:
GET http://example.com/api/v3/projects?private_token=QVy1PB7sTxfy4pqfZM1U
The API uses JSON to serialize data. You don't need to specify .json at the end of API URL.
Pagination
When listing resources you can pass the following parameters:
page(default:1) - page numberper_page(default:20, max:100) - number of items to list per page