Навигация

■ Дашборд

⎇ Базы данных

★ Метаданные

📋 Шаблоны запросов

≫ Консоль запросов

☰ Журнал регистрации

🔌 Расширения

Администрирование

🔑 Доступы / Токены

📖 API Справка

Информация

ⓘ О системе

Дашборд

Обзор подключённых баз 1С

Баз данных --

Онлайн --

Оффлайн --

Текущая база --

Подключённые базы

⎇

Загрузка баз данных...

Базы данных

Подключённые базы 1С и их статус

⎇

Загрузка...

Метаданные

Структура объектов конфигурации 1С

Загрузите метаданные

Выберите базу данных

Выберите объект из дерева метаданных

Шаблоны запросов

Готовые запросы для типовых операций с базой 1С

Загрузка шаблонов...

Выберите шаблон из списка слева

Консоль запросов

Выполнение запросов к базе данных 1С

Результат

≫

Введите запрос и нажмите "Выполнить"

Журнал регистрации

Журнал событий базы данных 1С

☰

Настройте фильтры и нажмите "Загрузить"

Управление доступами

Создание и управление API-токенами для внешних сервисов

Создать новый токен

Название сервиса *

Тип доступа

Базы данных Ctrl+Click для выбора нескольких

Разрешённые endpoint'ы Ctrl+Click для выбора нескольких

Срок действия Оставьте пустым для бессрочного

Описание

Активные токены

Загрузка...

API Справка

Документация REST API для интеграции внешних сервисов

Аутентификация

Все запросы к API требуют токен в заголовке:

X-API-Token: <ваш_токен>

Или через GET-параметр: ?token=<ваш_токен>

Токены создаются на странице Доступы / Токены. Каждый токен имеет тип, список разрешённых баз и endpoint'ов.

Базовый URL

https://1c.aplo.pw/api/proxy.php

Все запросы идут через прокси-сервер, который безопасно перенаправляет их в 1С.

Типы токенов

Тип	Описание	Права
admin	Полный доступ	Все базы, все endpoint'ы, управление токенами
service	Сервисный	Чтение + выполнение запросов (по настроенным базам/endpoint'ам)
readonly	Только чтение	Только GET endpoint'ы: version, configuration, metadata, object, form

Endpoint'ы

GET ?db={db}&endpoint=version

Версия расширения mcp-1c, установленного в базе.

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

curl -H "X-API-Token: YOUR_TOKEN" \
  "https://1c.aplo.pw/api/proxy.php?db=aplosoft&endpoint=version"

Ответ

{
  "success": true,
  "http_code": 200,
  "data": {
    "version": "0.4.0"
  }
}

GET ?db={db}&endpoint=configuration

Информация о конфигурации 1С: название, версия, поставщик, версия платформы, режим работы.

Ответ

{
  "success": true,
  "data": {
    "name": "БухгалтерияПредприятия",
    "version": "3.0.190.11",
    "vendor": "Фирма \"1С\"",
    "platform_version": "8.3.27.1688",
    "mode": "file"
  }
}

GET ?db={db}&endpoint=metadata

Полное дерево метаданных конфигурации: справочники, документы, регистры, перечисления, обработки, отчёты и др. Возвращает имена всех объектов по группам.

Ответ (сокращённо)

{
  "success": true,
  "data": {
    "Справочники": ["Банки", "БанковскиеСчета", "Валюты", ...],
    "Документы": ["ПоступлениеНаСчет", "СписаниеСоСчета", ...],
    "РегистрыСведений": [...],
    "РегистрыНакопления": [...],
    ...
  }
}

GET ?db={db}&endpoint=object/{Type}/{Name}

Структура конкретного объекта метаданных: реквизиты, табличные части, измерения, ресурсы.

Type Тип объекта: Catalog, Document, InformationRegister, AccumulationRegister, Enum, Report, DataProcessor и др.

Name Имя объекта на языке конфигурации (например Контрагенты)

Пример

GET ?db=aplosoft&endpoint=object/Catalog/Контрагенты

Ответ

{
  "success": true,
  "data": {
    "name": "Контрагенты",
    "synonym": "Контрагенты",
    "attributes": [
      {"name": "ИНН", "synonym": "ИНН", "type": "Строка"},
      {"name": "КПП", "synonym": "КПП", "type": "Строка"},
      ...
    ],
    "tabularParts": [...]
  }
}

POST ?db={db}&endpoint=query

Выполнение запроса на языке запросов 1С. Только SELECT/ВЫБРАТЬ — модификация данных запрещена.

query (string, обязательный) Текст запроса

limit (int, опционально) Максимум строк (по умолчанию 100, макс. 1000)

parameters (object, опционально) Параметры запроса {ИмяПараметра: значение}

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

curl -X POST -H "X-API-Token: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "ВЫБРАТЬ Наименование, Код ИЗ Справочник.Номенклатура ГДЕ НЕ ПометкаУдаления", "limit": 10}' \
  "https://1c.aplo.pw/api/proxy.php?db=aplosoft&endpoint=query"

Ответ

{
  "success": true,
  "data": {
    "columns": ["Наименование", "Код"],
    "rows": [
      ["Товар 1", "000001"],
      ["Товар 2", "000002"]
    ],
    "total": 2,
    "truncated": false
  }
}

POST ?db={db}&endpoint=validate-query

Проверка синтаксиса запроса без выполнения.

query (string, обязательный) Текст запроса для проверки

Ответ (ошибка)

{
  "success": true,
  "data": {
    "valid": false,
    "errors": ["Поле не найдено \"НесуществующееПоле\""]
  }
}

POST ?db={db}&endpoint=eventlog

Журнал регистрации базы 1С с фильтрацией.

start_date (ISO 8601, опционально) Дата начала

end_date (ISO 8601, опционально) Дата окончания

level (string, опционально) Уровень: Ошибка, Предупреждение, Информация, Примечание

user (string, опционально) Имя пользователя

limit (int, опционально) Макс. записей (по умолчанию 50, макс. 500)

GET ?db={db}&endpoint=form/{Type}/{Name}

Структура основной формы объекта: элементы, команды, обработчики событий.

Type Тип объекта (как в /object)

Name Имя объекта

Шаблоны запросов

Готовые запросы для типовых операций. Внешним сервисам не нужно знать структуру 1С — достаточно вызвать шаблон по ID.

GET /api/templates.php?action=list

Каталог всех доступных шаблонов (без текста запросов). Используйте для отображения списка пользователю или для автоматического обнаружения шаблонов.

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

curl -H "X-API-Token: YOUR_TOKEN" \
  "https://1c.aplo.pw/api/templates.php?action=list"

Ответ

{
  "success": true,
  "templates": [
    {
      "id": "users_active",
      "group": "Пользователи",
      "name": "Активные пользователи",
      "desc": "Только действующие пользователи",
      "params": []
    },
    {
      "id": "recent_sales",
      "group": "Документы",
      "name": "Последние реализации",
      "desc": "Реализации товаров и услуг за период",
      "params": [
        {"name": "ДатаНачала", "label": "Дата начала", "type": "date", "default": "-30d"},
        {"name": "ДатаОкончания", "label": "Дата окончания", "type": "date", "default": "now"}
      ]
    },
    ...
  ]
}

GET /api/templates.php?action=get&id={template_id}

Получить полную информацию о шаблоне, включая текст запроса 1С и описание параметров.

id (string, обязательный) Идентификатор шаблона

Пример

curl -H "X-API-Token: YOUR_TOKEN" \
  "https://1c.aplo.pw/api/templates.php?action=get&id=user_access_rights"

Ответ

{
  "success": true,
  "template": {
    "id": "user_access_rights",
    "group": "Пользователи",
    "name": "Права пользователей",
    "desc": "Какие группы доступа назначены каждому пользователю",
    "query": "ВЫБРАТЬ ... ИЗ Справочник.ГруппыДоступа.Пользователи ...",
    "params": []
  }
}

POST /api/templates.php?action=execute&id={template_id}&db={db}

Основной endpoint для внешних сервисов. Собирает запрос из шаблона с подставленными параметрами и сразу выполняет его в указанной базе. Один вызов — готовый результат.

id (string, обязательный) Идентификатор шаблона

db (string, обязательный) Идентификатор базы данных

parameters (object, в теле JSON) Параметры шаблона. Для дат: ISO-дата (2025-01-01), относительная (-30d, -7d) или now

limit (int, в теле JSON, опционально) Макс. строк результата (по умолчанию 200, макс. 1000)

Пример: шаблон без параметров

curl -X POST -H "X-API-Token: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}' \
  "https://1c.aplo.pw/api/templates.php?action=execute&id=users_active&db=aplosoft"

Пример: шаблон с параметрами (даты)

curl -X POST -H "X-API-Token: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"parameters": {"ДатаНачала": "-30d", "ДатаОкончания": "now"}, "limit": 50}' \
  "https://1c.aplo.pw/api/templates.php?action=execute&id=recent_sales&db=aplosoft"

Пример: поиск контрагента

curl -X POST -H "X-API-Token: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"parameters": {"Поиск": "%Газпром%"}}' \
  "https://1c.aplo.pw/api/templates.php?action=execute&id=counterparties_search&db=aplosoft"

Ответ

{
  "success": true,
  "template": {"id": "users_active", "name": "Активные пользователи", "group": "Пользователи"},
  "data": {
    "columns": ["Наименование", "ИдентификаторПользователяИБ", "Служебный"],
    "rows": [
      ["ACC", "d7ae72a5-7458-499a-84b9-572f3f804033", false],
      ["Aplo1C", "7999dda0-8ecc-462c-9965-49cef2149bb4", false],
      ["Pavel", "d67c305f-46b1-44bf-869c-d274f0edd145", false]
    ],
    "total": 3,
    "truncated": false
  }
}

POST /api/templates.php?action=build&id={template_id}

Собрать запрос из шаблона с подставленными параметрами без выполнения. Полезно для отладки или если нужно модифицировать запрос перед выполнением через /query.

Ответ

{
  "success": true,
  "query": "ВЫБРАТЬ ... ГДЕ Дата >= ДАТАВРЕМЯ(2025, 02, 09) И Дата <= ДАТАВРЕМЯ(2026, 03, 11) ...",
  "parameters": {},
  "limit": 200
}

Доступные шаблоны

ID	Группа	Название	Параметры
Загрузка...

Прочие endpoint'ы

Список баз данных GET

GET https://1c.aplo.pw/api/databases.php
Header: X-API-Token: YOUR_TOKEN

Возвращает список доступных баз данных (без credentials).

Коды ошибок

Код	Описание
`200`	Успешный запрос
`400`	Ошибка в запросе (неверные параметры, ошибка синтаксиса запроса 1С)
`401`	Токен не указан или неверный
`403`	Доступ запрещён (токен не имеет прав на эту базу/endpoint)
`404`	Объект не найден / база данных не найдена
`502`	Ошибка подключения к серверу 1С

Тестовая консоль

Метод

Endpoint

Тело запроса (JSON, для POST)

Ответ

Нажмите "Отправить"

Расширения конфигурации

Готовые расширения 1С для установки в базы данных

🔌

Загрузка расширений...

О системе

Информация о подключении

AploSoft 1C Dashboard

Веб-панель для работы с базами данных 1С:Предприятие через HTTP-сервисы (mcp-1c).

Версия панели 1.0.0

Протокол mcp-1c HTTP Services

Доступные endpoint'ы /version, /configuration, /metadata, /object, /query, /eventlog, /form