To maximize efficiency and protect your plant floor when using the WinCC REST API, implement the following best practices:
The WinCC REST API acts as a secure gateway to the runtime environment. Depending on your WinCC version (such as WinCC Unified or WinCC V8), the API typically exposes endpoints to handle three core pillars of SCADA data: 1. Tag Management (Read/Write Process Values)
that enables external applications to exchange data with the SCADA system using standard web protocols. It allows for both pulling data from WinCC (Server mode) and pushing data to external services (Connector mode). Key Capabilities Data Access wincc rest api
| Feature | Description | |---------|-------------| | | Read real-time values of PLC tags, internal tags, or user-defined variables. | | Write tags | Write single or multiple tags (e.g., setpoints, commands). | | Browse tags | Retrieve the tag structure (tag names, data types, groups). | | Read/write data blocks | Access structured PLC data (DBs) in WinCC Unified. | | Alarm & event retrieval | Get current and archived alarms/messages. | | User authentication | WinCC user management (login/logout, check permissions). | | Audit trail (if enabled) | Log changes made via REST API. |
url = "https://192.168.1.100:5001/api/v1" auth = requests.post(f"url/auth/login", json="username":"api_user","password":"xxx", verify=False) token = auth.json()["token"] To maximize efficiency and protect your plant floor
curl -X POST https://192.168.1.100:5001/api/v1/auth/login \ -H "Content-Type: application/json" \ -d '"username":"operator","password":"secret"' \ -k # ignore self-signed certificate for testing
Reading and writing real-time tag values and configuration data. Historical Retrieval: It allows for both pulling data from WinCC
Unlike older DCOM or OPC DA interfaces, REST uses JSON over HTTP/HTTPS—meaning any programming language (Python, JavaScript, C#, etc.) or tool (Postman, Node-RED, Power BI) can integrate without special COM libraries or Windows-only dependencies.
┌────────────────────────────────────────────────────────┐ │ IT Enterprise Layer │ │ (Python Scripts, ERP/MES, Power BI, Postman, etc.) │ └───────────────────────────┬────────────────────────────┘ │ HTTP Requests (GET, POST) │ JSON Payloads / HTTPS ▼ ┌────────────────────────────────────────────────────────┐ │ WinCC REST Service │ │ (Self-Hosted Microsoft C++ SDK Port Monitor) │ └───────────────────────────┬────────────────────────────┘ │ Internal RT Access ▼ ┌────────────────────────────────────────────────────────┐ │ WinCC Runtime Framework │ │ [Tag Management] [Archiving System] [Alarms] │ └────────────────────────────────────────────────────────┘ Core Components