Documentation

@catalogicus-international/n8n-nodes-autograph

n8n community nodes for the AutoGRAPH Service API.

Features

  • 13 nodes matching every group in the pinned AutoGRAPH 2026.1.2.1 OpenAPI document.
  • Coverage of 192 paths and 305 GET/POST method definitions.
  • Separate username/password Login and AG-Token credentials.
  • Custom API requests and binary report/photo downloads.
  • Polling trigger for changes in online device snapshots.
  • No runtime dependencies outside n8n-workflow.

Authentication

Use AutoGRAPH Login API credentials with AutoGRAPH Authentication to obtain a token. Pass its token and baseUrl fields to the Session Token Override and Base URL Override parameters of another node.

For scheduled workflows and AutoGRAPH Trigger, store the server URL and ready token in AutoGRAPH Token API credentials. API calls send the token through the AG-Token header and never add it to the query string.

Nodes

The package includes Authentication, Core Service, Device Data, Properties, Object Management, Administration, Reports, Application Data, Billing, Virtual Trees, Technical Control, Object Settings, Miscellaneous, Custom API, and Trigger nodes.

Each API-group node offers the operations discovered in its OpenAPI tag. Use Fields for documented parameters or Raw JSON for server-specific request shapes. The Custom API node accepts only relative /ServiceJSON/... paths.

Arrays are returned as separate n8n items. Online information maps include deviceId. Reports, photos, and ZIP files are returned in the data binary property.

Trigger

AutoGRAPH Trigger polls GetOnlineInfoAll or GetOnlineInfo. The first active poll establishes a baseline. Later executions emit changed devices with previous, current, and changedFields. Manual execution returns the current snapshot without changing the baseline.

Development

pnpm install
pnpm generate
pnpm test
pnpm run lint
pnpm run build
npm pack --dry-run

The OpenAPI registry is generated from openapi/autograph-2026.1.2.1.json. Generated runtime files are committed; builds do not use the network.

Русский

Пакет предоставляет 15 нод n8n для AutoGRAPH: отдельную авторизацию, 12 функциональных групп Swagger, универсальный API-запрос и polling trigger.

Для интерактивного workflow используйте AutoGRAPH Authentication, затем передайте token в Session Token Override, а baseUrl — в Base URL Override. Для расписаний и Trigger сохраните готовый токен в credentials AutoGRAPH Token API.

В групповых нодах режим Fields показывает параметры OpenAPI, а Raw JSON позволяет передать объекты query и body. Отчёты, фотографии и ZIP возвращаются как binary data. Trigger на первом рабочем опросе сохраняет исходное состояние, а затем выдаёт только изменившиеся online-снимки устройств.

License

MIT

Discussion