REST API v1 Stable

Programmatic access to WUP/BTLx parsing, TCN conversion, and BOM generation.

Endpoints

Authentication GET /api/v1?action=status GET /api/v1?action=machines POST /api/v1?action=parse_wup POST /api/v1?action=parse_btlx POST /api/v1?action=wup_to_tcn POST /api/v1?action=wup_bom Error handling Rate limits

Authentication

All API requests require a Bearer token. Contact us to obtain an API key.

Authorization: Bearer YOUR_API_KEY

If no API keys are configured (development mode), the API is open access.

Health Check

GET /api/v1?action=status

Returns API status and list of available endpoints.

{
  "status": "ok",
  "version": "1.0.0",
  "endpoints": ["GET /api/v1?action=status", ...]
}

Machine Profiles

GET /api/v1?action=machines

Returns available CNC machine profiles with depth limits and capabilities.

{
  "machines": {
    "WBS120": {"depth_limit": 120, "type": "weinmann", ...},
    "TPA6": {"depth_limit": 200, "type": "tpa", ...},
    ...
  }
}

Parse WUP File

POST /api/v1?action=parse_wup

Parse a Dietrich's WUP file and return structured wall data.

Request body

Field	Type	Description
file	string required	Base64-encoded WUP file content

curl -X POST "https://your-domain/api/v1?action=parse_wup" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"file": "VFhUICAgIERp..."}'

Response

{
  "wall_data": {
    "width": 3000.0,
    "height": 2000.0,
    "thickness": 105.0,
    "studs": [{"x": 0.0, "dim1": 45.0, "dim2": 105.0}, ...],
    "panels": 1,
    "operations": 42
  }
}

Parse BTLx File

POST /api/v1?action=parse_btlx

Parse a BTLx XML file and return part information.

Request body

Field	Type	Description
file	string required	Base64-encoded BTLx file content

Response

{
  "parts_count": 16,
  "parts": [
    {
      "id": "1",
      "name": "Stud_1",
      "length": 2650.0,
      "width": 45.0,
      "height": 105.0,
      "processings": 2
    }, ...
  ]
}

WUP to TCN Conversion

POST /api/v1?action=wup_to_tcn

Convert a WUP file to TCN format for TPA Compact 6/8 CNC controllers.

Request body

Field	Type	Description
file	string required	Base64-encoded WUP file content
sub_path	string	Sub-program path (default: `.\assets\sub`)
machine	string	Machine profile ID (default: `generic`)

Response

{
  "tcn_files": {
    "PLA1 - WallName.tcn": "...",
    "PLA2 - WallName.tcn": "..."
  },
  "stats": {
    "wall_dims": "3000x2000x105 mm",
    "studs": [...],
    "stud_depth": 105
  }
}

WUP Bill of Materials

POST /api/v1?action=wup_bom

Generate a Bill of Materials from a WUP file.

Request body

Field	Type	Description
file	string required	Base64-encoded WUP file content

Error Handling

All errors return JSON with an error field:

{
  "error": "Description of the error"
}

Status	Meaning
400	Bad request (missing parameters, unknown action)
401	Unauthorized (invalid or missing API key)
413	File too large (max 4MB)
500	Internal server error (parse/conversion failure)

Rate Limits

Default: 60 requests per minute per API key. Contact us for higher limits.