Получение списка документов с открытым доступом
Метод Get list of free access documents используется для получения списка документов реселлера с открытым доступом.
Для авторизации требуется API-токен менеджера (сотрудника). API-токен можно получить через Панель управления Оператора (см. Просмотр и обновление информации о сотруднике).
По указанному в запросе API-токену определяются:
- Роль и уровень доступа менеджера, от которых зависит доступность метода.
- Текущий реселлер и его нижестоящие реселлеры, доступные в рамках метода.
GET {base_url}/api/v3/resellers/{reseller_id}/free_access_documents
Аргументы
Название | Тип параметра | Тип данных | Обязательный/ | Описание |
---|---|---|---|---|
X-Api-Token | header | string | Обязательный | API-токен сотрудника, выполняющего операцию (см. Просмотр и обновление информации о сотруднике) |
Content-Type | header | string | Обязательный | Тип данных, передаваемых в запросе. Необходимо указать: application/vnd.api+json |
Accept | header | string | Обязательный | Поддерживаемые типы данных в ответе. Необходимо указать: application/vnd.api+json |
base_url | path | string | Обязательный | URL ActivePlatform |
reseller_id | path | number | Обязательный | ID реселлера. Возможно указать ID текущего реселлера или ID любого из его нижестоящих реселлеров (см. Просмотр информации о реселлере) |
page[size] | query | integer | Опциональный | Параметр постраничной навигации. Количество элементов на странице ответа (50 по умолчанию) |
page[number] | query | integer | Опциональный | Параметр постраничной навигации. Номер страницы ответа |
Модель ответа
Название | Тип данных | Описание | ||||
---|---|---|---|---|---|---|
data | array of objects | Данные ответа | ||||
id | string | ID документа в платформе | ||||
type | string | Тип данных | ||||
attributes | object | Информация о документе | ||||
created_at | string | Дата и время создания документа | ||||
updated_at | string | Дата и время последнего обновления документа | ||||
name | string | Название документа | ||||
url | string | Новая ссылка на документ в файловом хранилище | ||||
links | array | Ссылки на страницы для навигации по элементам ответа с учетом заданных параметров постраничной навигации | ||||
self | string | Ссылка на текущую страницу | ||||
first | string | Ссылка на первую страницу | ||||
prev | string | Ссылка на предыдущую страницу | ||||
next | string | Ссылка на следующую страницу | ||||
last | string | Ссылка на последнюю страницу |
Пример запроса
GET /api/v3/resellers/1/free_access_documents
Host: test.activeplatform.com
Content-Type: application/vnd.api+json
X-Api-Token: vY5fwetestK3gJXZH5uHCw
Accept: application/vnd.api+json
Пример ответа
{
"data": [
{
"id": "51",
"type": "free_access_documents",
"attributes": {
"created_at": "2020-10-08T02:11:20.932646+0300",
"updated_at": "2020-10-08T02:11:20.932646+0300",
"name": "1.pdf",
"url": "https://storage.test.activeplatform.com/public/free_access_documents/731c1c83578f8a7c14d0173dadbc72f1.pdf"
}
},
{
"id": "52",
"type": "free_access_documents",
"attributes": {
"created_at": "2020-10-08T02:16:43.247122+0300",
"updated_at": "2020-10-08T02:16:43.247122+0300",
"name": "2.pdf",
"url": "https://storage.test.activeplatform.com/public/free_access_documents/7610e1125f87af27367d53b58661975a.pdf"
}
},
{
"id": "55",
"type": "free_access_documents",
"attributes": {
"created_at": "2020-10-09T16:49:12.819600+0300",
"updated_at": "2020-10-09T16:49:12.819600+0300",
"name": "5.pdf",
"url": "https://storage.test.activeplatform.com/public/free_access_documents/b482623013d660c59bace40c4dcec419.pdf"
}
}
],
"links": {
"self": "https://test.activeplatform.com/api/v3/resellers/1/free_access_documents/?page%5Bnumber%5D=1&page%5Bsize%5D=50",
"first": "https://test.activeplatform.com/api/v3/resellers/1/free_access_documents/?page%5Bnumber%5D=1&page%5Bsize%5D=50",
"prev": null,
"next": null,
"last": "https://test.activeplatform.com/api/v3/resellers/1/free_access_documents/?page%5Bnumber%5D=1&page%5Bsize%5D=50"
}
}