| Method | Endpoint | Description | |--------|------------------------------|-------------------------------------------| | GET | /tags | List all tags (paginated) | | GET | /tags/<name> | Read single tag value | | POST | /tags/read | Batch read multiple tags | | POST | /tags/write | Write one or more tags | | GET | /alarms/active | Get current active alarms | | GET | /alarms/history | Query alarm log (with filters) | | POST | /alarms/acknowledge | Acknowledge an alarm by ID | | GET | /archives/<tag>/values | Historical values over time range | | GET | /status | WinCC runtime status (running/stopped) | Request (Write tag TankLevel to 75.5):
The (available in WinCC Professional V7.5 SP2 and later, as well as WinCC OA) provides a RESTful interface to read/write process tags, acknowledge alarms, and retrieve archive data. This paper documents its capabilities and practical integration. 2. Architecture Overview The WinCC REST API is implemented as an additional service running on the WinCC station. It communicates with the WinCC Runtime Database via internal COM interfaces. wincc rest api
POST /api/v1/tags/write Host: wincc-server:50051 Content-Type: application/json Authorization: Negotiate ... "TankLevel": 75.5 Architecture Overview The WinCC REST API is implemented
$cred = Get-Credential $body = @tags=@("Tag1","Tag2") | ConvertTo-Json Invoke-RestMethod -Uri "https://wincc:50051/api/v1/tags/read" -Method Post -Body $body -Credential $cred -ContentType "application/json" "TankLevel": 75
:
"success": true, "timestamp": "2025-03-15T14:32:10Z", "results": "TankLevel": "value": 75.5, "quality": "good"