About enums

When sending enum values to the ManWinWin API, it is recommended to use the corresponding text value as opposed to the numeric representation. This recommendation is based on the folowing:

  1. Enhanced Human Readability: Utilizing text values renders the information more easily comprehensible to individuals, facilitating improved understanding and communication.

  2. Future-Proofing Against Numeric Changes: Numeric values associated with enums may undergo modifications in subsequent updates. To preempt potential issues stemming from such alterations, utilizing text values ensures resilience to numerical adjustments.

For instance, when creating a Maintenance Request, it is recommended to set the "CostAllocation.Type" parameter to the respective text representation rather than relying on the numeric value:

{ "Title": "something is not working", "Urgency": "Emergency", "CostAllocation": { "Type": "CostCenter", "Code": "Z01" } }

This practice aligns with best practices for optimal system compatibility and long-term stability.