OAS 2.1 cleanup

[hrdlickap]

API 2.1 cleanup

Consistency and accuracy pass over the 2.1 spec. Bundles and lints clean (redocly lint → 0 warnings).

Schema

• proposal (all *ValidationResult schemas): documented as a string with the complete list of possible values, plus an explanation of how the value is composed (validity of result × validity of resultCorrected × presence of suggestions). email/validate additionally documents the unknown* variants. It is never null.
• Error description: modelled as a nullable string (type: [string, "null"]) rather than an enum, since the message text can change and may be null for some errors.
• client.ip: now documented as an IPv4 or IPv6 address (used for geolocation), with examples for both.

Servers & versioning

• Removed the /v2.1 path server and the duplicated per-operation servers blocks. The API version is selected through the Api-Version header.

Content

• Regenerated the Supported countries table in the API description from the dataSource definitions.
• Reworded the registration note and unified the link to app.foxentry.com/registration.
• Fixed typos in a few descriptions.

Verification

redocly bundle openapi.yaml
redocly lint openapi.yaml    # valid, 0 warnings

[hrdlickap]

Updated per review: full proposal value list, bundle.sh fail-fast restored, registration wording reworded.

Also fixed ErrorValueGlobal.yaml, where an enum was left alongside the new nullable type — now consistent with the other error schemas.

redocly lint → 0 warnings.