Platform — действия с версиями платформы 1С:Предприятие

Методы группы platform внешнего программного интерфейса менеджера сервиса предназначены для выполнения различных действий с версиями платформы 1С:Предприятие, используемых облачным сервисом Фреш.

Сводка по методам

Метод	Назначение
platform/create	Зарегистрировать новую версию платформы 1С:Предприятие
platform/delete	Пометить на удаление или снять пометку удаления версии платформы 1С:Предприятие
platform/info	Информация о версии платформы 1С:Предприятие
platform/list	Список используемых в сервисе версий платформы 1С:Предприятие
platform/update	Изменить информацию о версии платформы 1С:Предприятие

platform/create

Зарегистрировать новую версию платформы 1С:Предприятие

Параметр	Тип	Описание	Пример
Запрос
version	Строка переменная (18)	Номер версии	8.3.14.1694
type	Строка (перечисление)	Тип версии: Релиз Тестовая	Релиз
description *	Строка неограниченной длины	Описание версии	Пример описания версии платформы 1С:Предприятия
Ответ
version	Строка переменная (18)	Номер версии	8.3.14.1694
updated *	Булево	Элемент изменен	true
created *	Булево	Создан новый элемент	true
change_list	Список (0..*)	Список изменений
- name	Строка переменная (255)	Имя поля
- value *	Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево, Уникальный идентификатор, Двоичные данные неограниченного размера в строке Base64, Массив, Структура	Установленное значение
- old_value *	Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево, Уникальный идентификатор, Двоичные данные неограниченного размера в строке Base64, Массив, Структура	Прежнее значение

Пример запроса Развернуть

POST https://1cfresh.com/a/adm/hs/ext_api/execute/srv/platform/create
Authorization: Basic base64_encode(user:password) или Bearer access_token

{
  "version": "8.3.14.1694",
  "type": "Релиз",
  "description": "Пример описания версии платформы 1С:Предприятия"
}

Пример ответа Развернуть

{
  "version": "8.3.14.1694",
  "updated": true,
  "created": true,
  "change_list": [
    {
      "name": "Строковое значение (пример)",
      "value": "Строковое значение (пример)",
      "old_value": "Строковое значение (пример)"
    }
  ],
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 28,
    "sm_version": "1.1.37.1",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

platform/delete

Пометить на удаление или снять пометку удаления версии платформы 1С:Предприятие

Параметр	Тип	Описание	Пример
Запрос
version	Строка переменная (18)	Номер версии	8.3.13.1809
deletion_mark	Булево	Пометка удаления	true
Ответ
version	Строка переменная (18)	Номер версии	8.3.13.1809
updated *	Булево	Элемент изменен	true
created *	Булево	Создан новый элемент	false
change_list	Список (0..*)	Список изменений
- name	Строка переменная (255)	Имя поля	deletion_mark
- value *	Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево, Уникальный идентификатор, Двоичные данные неограниченного размера в строке Base64, Массив, Структура	Установленное значение	true
- old_value *	Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево, Уникальный идентификатор, Двоичные данные неограниченного размера в строке Base64, Массив, Структура	Прежнее значение	false

Пример запроса Развернуть

POST https://1cfresh.com/a/adm/hs/ext_api/execute/srv/platform/delete
Authorization: Basic base64_encode(user:password) или Bearer access_token

{
  "version": "8.3.13.1809",
  "deletion_mark": true
}

Пример ответа Развернуть

{
  "version": "8.3.13.1809",
  "updated": true,
  "created": false,
  "change_list": [
    {
      "name": "deletion_mark",
      "value": true,
      "old_value": false
    }
  ],
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 28,
    "sm_version": "1.1.37.1",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

platform/info

Информация о версии платформы 1С:Предприятие

Параметр	Тип	Описание	Пример
Запрос
version	Строка переменная (18)	Номер версии	8.3.13.1809
Ответ
version *	Строка переменная (18)	Номер версии	8.3.13.1809
deletion_mark *	Булево	Пометка удаления	false
type *	Строка (перечисление)	Тип версии: Релиз Тестовая	Релиз
description *	Строка неограниченной длины	Описание версии

Пример запроса Развернуть

POST https://1cfresh.com/a/adm/hs/ext_api/execute/srv/platform/info
Authorization: Basic base64_encode(user:password) или Bearer access_token

{
  "version": "8.3.13.1809"
}

Пример ответа Развернуть

{
  "version": "8.3.13.1809",
  "deletion_mark": false,
  "type": "Релиз",
  "description": "",
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 28,
    "sm_version": "1.1.37.1",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

platform/list

Список используемых в сервисе версий платформы 1С:Предприятие

Параметр	Тип	Описание	Пример
Запрос
version *	Строка переменная (18)	Номер версии	8.3.13.1809
Ответ: list (1..*)
version	Строка переменная (18)	Номер версии	8.3.13.1809
deletion_mark	Булево	Пометка удаления	false
type	Строка (перечисление)	Тип версии: Релиз Тестовая	Релиз

Пример запроса Развернуть

POST https://1cfresh.com/a/adm/hs/ext_api/execute/srv/platform/list
Authorization: Basic base64_encode(user:password) или Bearer access_token

Пример ответа Развернуть

{
  "list": [
    {
      "version": "8.3.13.1809",
      "deletion_mark": false,
      "type": "Релиз"
    }
  ],
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 28,
    "sm_version": "1.1.37.1",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх

platform/update

Изменить информацию о версии платформы 1С:Предприятие

Параметр	Тип	Описание	Пример
Запрос
version	Строка переменная (18)	Номер версии	8.3.13.1809
type *	Строка (перечисление)	Тип версии: Релиз Тестовая	Релиз
description *	Строка неограниченной длины	Описание версии	Пример описания версии платформы 1С:Предприятия
Ответ
version	Строка переменная (18)	Номер версии	8.3.13.1809
updated *	Булево	Элемент изменен	true
created *	Булево	Создан новый элемент	false
change_list	Список (0..*)	Список изменений
- name	Строка переменная (255)	Имя поля	description
- value *	Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево, Уникальный идентификатор, Двоичные данные неограниченного размера в строке Base64, Массив, Структура	Установленное значение	Пример описания версии платформы 1С:Предприятия
- old_value *	Число (любое), Строка неограниченной длины, Дата и время в строке формата ISO, Булево, Уникальный идентификатор, Двоичные данные неограниченного размера в строке Base64, Массив, Структура	Прежнее значение

Пример запроса Развернуть

POST https://1cfresh.com/a/adm/hs/ext_api/execute/srv/platform/update
Authorization: Basic base64_encode(user:password) или Bearer access_token

{
  "version": "8.3.13.1809",
  "type": "Релиз",
  "description": "Пример описания версии платформы 1С:Предприятия"
}

Пример ответа Развернуть

{
  "version": "8.3.13.1809",
  "updated": true,
  "created": false,
  "change_list": [
    {
      "name": "description",
      "value": "Пример описания версии платформы 1С:Предприятия",
      "old_value": ""
    }
  ],
  "general": {
    "response": 10200,
    "error": false,
    "message": "",
    "version": 28,
    "sm_version": "1.1.37.1",
    "sm_timezone": "Europe/Moscow"
  }
}

Вверх