Дашборд

Обзор подключённых баз 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 Имя объекта

Список баз данных 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)

Ответ

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

О системе

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

AploSoft 1C Dashboard

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

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

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

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