Получение списка файлов
Возвращает список загруженных файлов магазина.
Возвращаются только изображения (IMAGE) и прочие файлы (OTHER).
Видео хранятся отдельно — используйте GET /v1/videos.
Request
GET
https://api.kit.yandex.net/v1/files
Query parameters
|
Name |
Description |
|
page |
Type: integer Номер страницы. Default: Min value: |
|
per_page |
Type: integer Количество элементов на странице. Default: Min value: Max value: |
Responses
200 OK
Список файлов.
Body
application/json
{
"files": [
{
"id": "019b30d4-3e28-7a98-ae46-cb66932d1936",
"type": "IMAGE",
"url": "https://example.com/files/550e8400-e29b-41d4-a716-446655440000.png"
}
],
"total_count": 100
}
|
Name |
Description |
|
files |
Type: File[] Example |
|
total_count |
Type: integer Общее количество файлов. |
FileID
Идентификатор файла.
Type: string<uuid>
Example: 019b30d4-3e28-7a98-ae46-cb66932d1936
FileType
Тип файла.
Type: string
Enum: IMAGE, VIDEO, OTHER
File
|
Name |
Description |
|
id |
Type: FileID Идентификатор файла. Example: |
|
type |
Type: FileType Тип файла. Enum: |
|
url |
Type: string<uri> Публичный URL для доступа к файлу. Example: |
Example
{
"id": "019b30d4-3e28-7a98-ae46-cb66932d1936",
"type": "IMAGE",
"url": "https://example.com/files/550e8400-e29b-41d4-a716-446655440000.png"
}
400 Bad Request
Некорректный запрос.
Body
application/json
{
"code": "VALIDATION_ERROR",
"message": "Invalid input",
"trace_id": "00000000000000000000000000000000"
}
|
Name |
Description |
|
code |
Type: string Example: |
|
message |
Type: string Example: |
|
trace_id |
Type: string Уникальный идентификатор запроса для отладки. Example: |
401 Unauthorized
Не авторизован.
Body
application/json
{
"code": "VALIDATION_ERROR",
"message": "Invalid input",
"trace_id": "00000000000000000000000000000000"
}
|
Name |
Description |
|
code |
Type: string Example: |
|
message |
Type: string Example: |
|
trace_id |
Type: string Уникальный идентификатор запроса для отладки. Example: |
500 Internal Server Error
Внутренняя ошибка сервера.
Body
application/json
{
"code": "VALIDATION_ERROR",
"message": "Invalid input",
"trace_id": "00000000000000000000000000000000"
}
|
Name |
Description |
|
code |
Type: string Example: |
|
message |
Type: string Example: |
|
trace_id |
Type: string Уникальный идентификатор запроса для отладки. Example: |