Список locations
Метод предназначен для просмотра списка объектов location
Параметры запроса
GET /api/clients/v1/locations/{id}/
Headers
- Content-Type: application/json
- Authorization: Bearer
$access_token
Query
Параметр | Тип | Ограничения | Описание | Пример |
---|---|---|---|---|
limit | integer | > 0 | Количество объектов в ответе | 50 |
offset | integer | > 0 | Смещение относительно начала списка | 0 |
project_id | integer | > 0 | ID проекта. Обязательный | 1 |
domain_id | integer | > 0 | ID домена. Обязательный | 1 |
Параметры ответа
JSON body
Параметр | Тип | Описание |
---|---|---|
count | integer | Общее количество locations |
next | string | Ссылка на предыдущую страницу |
previous | string | Ссылка на следующую страницу |
results | object[] | Список locations |
Примеры
200 OK
Объект location
{
"count": 123,
"next": "http://api.example.org/locations/?offset=400&limit=50",
"previous": "http://api.example.org/locations/?offset=200&limit=50",
"results": [
{
"id": 0,
"name": "/images",
"type": "matching",
"domain_id": 1,
"headers": [
{
"key": "Accept-Encoding",
"value": "gzip, deflate, br"
}
],
"cors_headers": {
"access_control_allow_origin": [
"*"
],
"access_control_expose_headers": [
"*"
],
"access_control_max_age": 86400,
"access_control_allow_credentials": true,
"access_control_allow_methods": [
"OPTIONS"
],
"access_control_allow_headers": [
"Accept-Encoding"
]
}
}
]
}
400 Bad Request
Указаны невалидные path-параметры
{
"project_id": [
"A valid integer is required."
],
"domain_id": [
"A valid integer is required."
]
}
401 Unauthorized
Учетные данные для аутентификации отсутствуют или недействительны
{
"detail": "Given token not valid for any token type",
"code": "token_not_valid",
"messages": [
{
"token_class": "AccessToken",
"token_type": "access",
"message": "Token is invalid or expired"
}
]
}
403 Forbidden
Только участники проекта могут просматривать этот объект location
{
"detail": "Only project participants can view this location"
}
404 Not Found
lcoation с таким ID не найден
{
"detail": "Not found"
}