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

Метод Update a free access document используется для обновления документа Реселлера с открытым доступом.

Доступ к текущему Реселлеру, относительно которого формируется список нижестоящих Реселлеров, определяется по токену Сотрудника, указанному в заголовке запроса.

PUT {base_url}/api/v3/resellers/{reseller_id}/free_access_documents/{free_access_document_id}

Аргументы

Название

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

Тип данных

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

Описание

X-Api-TokenheaderstringОбязательныйAPI токен Сотрудника, выполняющего операцию (см. Просмотр и обновление информации о сотруднике)
Content-TypeheaderstringОбязательныйПредназначен для идентификации формата и способа представления сущности
AcceptheaderstringОбязательныйПредназначен для информирования сервера о типах данных, которые поддерживаются клиентом (браузером)
reseller_idpathnumberОбязательныйID Реселлера. Возможно указать ID текущего Реселлера или ID любого из его нижестоящих Реселлеров (см. Просмотр информации о реселлере)

free_access_document_id

pathnumberОбязательныйID документа
fileformstringОбязательный

Документ в кодировке base64 с указанием MIME-типа данных (см. Список MIME-типов). Поддерживаются следующие форматы файлов:

  • .JPG
  • .JPEG
  • .PNG
  • .GIF
  • .PDF

Максимальный размер отправляемого файла документа зависит от настроек конкретной инсталляции и может быть изменен по обращению в службу технической поддержки.

Формат данных:

data:<MIME-тип данных>;base64,'содержимое в кодировке base64'

nameformstringОбязательныйНазвание документа

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

Название

Тип данных

Описание

dataobjectДанные ответа


id

string

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

typestringТип данных

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


created_at

string

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


updated_at

string

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


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


urlstringНовая ссылка на документ в файловом хранилище

Ошибки

Метод возвращает ответ со статусом 500 Internal Server Error, если в запросе неверно указан аргумент file:

  • Отсутствует запятая перед содержимым файла.
  • Не удается установить MIME-тип ни по содержимому файла, ни указанному типу.

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

PUT /api/v3/resellers/1/free_access_documents/56
Host: test.activeplatform.com
Content-Type: application/vnd.api+json
X-Api-Token: vY5fwetestK3gJXZH5uHCw
Accept: application/vnd.api+json
{
    "file": "data:application/pdf;base64,'SSBob2xkIHRoZSBwb3NpdGlvbiBvZiBhIHFhIGVuZ2luZWVyLiBRQSBlbmdpbmVlciByZXNwb25zaWJpbGl0aWVzIGluY2x1ZGUgZGVzaWduaW5nIGFuZCBpbXBsZW1lbnRpbmcgdGVzdHMsIGRlYnVnZ2luZyBhbmQgZGVmaW5pbmcgY29ycmVjdGl2ZSBhY3Rpb25zLiBJIGFsc28gcmV2aWV3IHN5c3RlbSByZXF1aXJlbWVudHMgYW5kIHRyYWNrIHF1YWxpdHkgYXNzdXJhbmNlIG1ldHJpY3MgKGUuZy4gZGVmZWN0IGRlbnNpdGllcyBhbmQgb3BlbiBkZWZlY3QgY291bnRzLikgVGhlIFFBIHRlY2huaWNpYW4gcm9sZSBwbGF5cyBhbiBpbXBvcnRhbnQgcGFydCBpbiBvdXIgY29tcGFueeKAmXMgcHJvZHVjdCBkZXZlbG9wbWVudCBwcm9jZXNzLg=='",
    "name": "1.pdf"
}

Пример ответа

{
    "data": {
        "id": "56",
        "type": "free_access_documents",
        "attributes": {
            "created_at": "2020-10-09T16:49:19.699819+0300",
            "updated_at": "2020-10-09T17:02:40.984184+0300",
            "name": "1.pdf",
            "url": "https://storage.test.activeplatform.com/public/free_access_documents/3231ef9932570a653b9ca71603d4373c.pdf"
        }
    }
}