Migration Guide — V1 to V2

This guide outlines the key changes between version 1 and version 2 of the Hyprace Formula 1 API. While most endpoints and data structures remain backward compatible, one major change affects how constructor information is represented.

What’s new in V2?

In V2, the constructor field previously used to represent the racing team has been replaced by a new, more detailed team object. This change allows for better separation of concerns and greater flexibility when representing modern F1 teams, which often use components from multiple manufacturers (e.g., engine, chassis, tyres).

Why This Matters

This V2 design enables:

• Precise technical modeling of teams and results
• Support for historical setups, including multi-engine seasons
• Correct Constructor standings calculation per FIA guidelines
• Tracking of models and their evolution over time
• Better representation of technical partnerships (e.g. engine customer teams)
• Aggregation of points across teams using identical technical configurations

Example

{
  "id": "d12e60bf-d848-48c0-997d-400cb510f4d6",
  "name": "ferrari",
  "materialInformation": [
    {
      "chassisId": "798bae8c-f55d-4e9c-bfc4-21386090a1ee",
      "engineId": "6f1fd062-2f7a-4d35-8e88-4fca8f9861fb",
      "chassisManufacturerId": "300e67a0-9bc5-429e-a419-c2a98bf8c7a7",
      "engineManufacturerId": "ae0fbc07-ccbb-4a7a-830a-f0be905e7cb2",
      "tyreManufacturerId": "203db8ca-05de-405d-b22b-1d75af4da410"
    }
  ]
}