Получение списка документов с открытым доступом

Метод Get list of free access documents используется для получения списка документов реселлера с открытым доступом.

Для авторизации требуется API-токен менеджера (сотрудника). API-токен можно получить через Панель управления Оператора (см. Просмотр и обновление информации о сотруднике).

По указанному в запросе API-токену определяются:

  • Роль и уровень доступа менеджера, от которых зависит доступность метода.
  • Текущий реселлер и его нижестоящие реселлеры, доступные в рамках метода.

GET {base_url}/api/v3/resellers/{reseller_id}/free_access_documents

Аргументы

Название

Тип параметра

Тип данных

Обязательный/ 
Опциональный

Описание

X-Api-TokenheaderstringОбязательныйAPI-токен сотрудника, выполняющего операцию (см. Просмотр и обновление информации о сотруднике)
Content-TypeheaderstringОбязательныйТип данных, передаваемых в запросе. Необходимо указать: application/vnd.api+json
AcceptheaderstringОбязательныйПоддерживаемые типы данных в ответе. Необходимо указать: application/vnd.api+json
base_urlpathstringОбязательныйURL ActivePlatform
reseller_idpathnumberОбязательныйID реселлера. Возможно указать ID текущего реселлера или ID любого из его нижестоящих реселлеров (см. Просмотр информации о реселлере)

page[size]

query

integer

Опциональный

Параметр постраничной навигации. Количество элементов на странице ответа (50 по умолчанию)

page[number]queryintegerОпциональныйПараметр постраничной навигации. Номер страницы ответа

Модель ответа

Название

Тип данных

Описание

dataarray of objectsДанные ответа


id

string

ID документа в платформе

typestringТип данных

attributesobjectИнформация о документе


created_at

string

Дата и время создания документа


updated_at

string

Дата и время последнего обновления документа


namestringНазвание документа


urlstringНовая ссылка на документ в файловом хранилище
linksarrayСсылки на страницы для навигации по элементам ответа с учетом заданных параметров постраничной навигации

selfstringСсылка на текущую страницу

firststringСсылка на первую страницу

prevstringСсылка на предыдущую страницу

nextstringСсылка на следующую страницу

laststringСсылка на последнюю страницу

Пример запроса

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"
    }
}