Documentation

Welcome to the Adsify documentation. Adsify is a .NET 10 REST API that wraps the Beckhoff TwinCAT ADS protocol, providing authenticated HTTP access to PLC variables, symbols, device state, lifecycle control, file access, and real-time notifications.

Who is this for?

• AI agents performing machine diagnostics via HTTP
• Remote HMI applications that need PLC data over the network
• Diagnostic tools that require authenticated, scoped access to PLCs

Key Concepts

• PLC Targets — configured TwinCAT runtimes identified by aliases (e.g., Line1, TestRig)
• Feature Slices — independently toggleable API feature groups (Variables, Symbols, DeviceInfo, Lifecycle, Notifications, Files)
• Hybrid Authorization — RBAC roles intersected with OAuth2 scopes determine effective permissions
• Embedded ADS Router — cross-platform ADS routing without a local TwinCAT installation