Скачать вложение заявлений
GET/api/v1/clients/:clientId/applicationGroups/:applicationGroupId/attachments/:attachmentId
Описание метода
Возвращает редирект для скачивания файла вложения группы заявлений сотрудника.
Валидации запроса
- Клиент существует, не удалён, и к нему относится пользователь, выполняющий операцию.
- IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. группы заявлений соответствует формату UUID.
- По заданному IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. существует группа заявлений.
- Группа заявлений по заданному IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. относится к клиенту.
- Пользователю клиента доступна группа заявлений.
- IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. вложения группы заявлений соответствует формату UUID.
- По заданному IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. существует вложение группы заявлений.
- Вложение группы заявлений сотрудника относится к заданной группе заявлений.
- Вложение группы заявлений сотрудника не удалено и не подлежит удалению по сроку хранения.
- IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента соответствует формату UUID.
- По заданному IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента существует клиент.
- Пользователь, выполняющий операцию, относится к клиенту.
- Пользователь клиента является создателем группы заявлений.
- Пользователь клиента является заявителем.
- Пользователь клиента является активным заместителем как минимум одного из подписантов группы заявлений.
- Пользователь клиента является получателем группы заявление и документооборот заявления успешно завершен подписанием со стороны всех участников.
- Если пользователю необходимо получить черновик заявления, проверяет, что он ему доступен, иначе в группе хотя бы одно заявление не является черновиком.
- Пользователь клиента имеет право на получение группы заявлений.
- Проверяет, что IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. вложения группы заявлений сотрудника, заданный в виде строки, соответствует формату, и возвращает типизированный IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. вложения группы заявлений сотрудника.
- Проверяет, что по заданному IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. существует вложение группы заявлений сотрудника.
- Проверяет, что вложение группы заявлений сотрудника относится к заданной группе заявлений.
- Проверяет, что вложение группы заявлений сотрудника не удалено и не подлежит удалению по сроку хранения.
- Проверяет, что текущий пользователь относится к заданному клиенту и возвращает пользователя клиента, если он существует.
- Проверяет, что IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента, заданный в виде строки, соответствует формату, и возвращает типизированный IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента.
- Проверяет существование клиента по заданному IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. и возвращает клиента, если он существует.
- Проверяет, что клиент не удален.
- Проверяет, что IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. группы заявлений, заданный в виде строки, соответствует формату, и возвращает типизированный IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. группы заявлений.
- Проверяет, что группа заявлений сотрудника относится к заданному клиенту.
- Проверяет, что черновик заявления доступен пользователю.
- Проверяет, что в группе заявлений есть хотя бы одно заявление, не являющееся черновиком.
- Пользователь является подписантом хотя бы в одном заявлении из группы заявлений и уже настал момент, когда ему стало доступно подписание заявления.
- Среди подписантов заявления, которым уже стало доступно подписание заявления, есть подписант, который относится к участнику с типом
ROLEи пользователь клиента имеет необходимую роль. - Пользователь клиента имеет право на получение группы заявлений на уровне роли пользователя клиента или сотрудника.
- Проверяет, что для заданной группы заявлений не истёк период хранения вложений.
Request
Responses
- 200
- 303
- 400
- 401
- 403
- 429
Этот код ответа не используется, при успехе выполнения метод всегда возвращает ответ с кодом 303.
HTTP-заголовок Location будет содержать URL, по которому скачивается файл.
✍️ Postman и некоторые другие API-клиенты по умолчанию следуют редиректам и сразу скачивают файл, указанный в
HTTP-заголовке Location. Это поведение настраивается на стороне клиента.
Response Headers
Location
URL, по которому скачивается файл
Example:
https://host.hr-link.ru/api/v1/files?token=<<одноразовый_токен>>Ошибка при валидации данных запроса.
Запрос не аутенифицирован.
Для заданного пользователя доступ к ресурсу запрещен.
Превышен разрешенный лимит запросов за период.