feat: update to openapi 3.1 and fix errors

[jbergstroem]

Lots of improvements to our openapi spec.

• Updates to OpenAPI 3.1
• Fixes issues related to upgrade (examples, minimumExample)
• Add reusable refs for opaqueUserID, resolvedBidID, occuredAt, id
• Fix issues in cyclic references
• Fix issues with incorrect examples
• add yamllint
• add redocly
• add vacuum
• update so yamllint and prettier configs are compatible with each other
• simplify typos config
• Rename Components that has a naming conflict with Central Services (Entity, Category)
• add maxlength to identifiers
• standardize authentication

So far, fixed around 170 errors.

Todo

This PR can land-as is and forthcoming changes can be added at a later date.

• incorrect toptimize types
• make more reusable components such as
  • occuredAt
  • id (marketplace)
• revert changes to auction example (splitting it up into multiple examples, mintlify only shows the first one)
• migrate x-examples into real ones
• fix v1 issues (might just skip it)

[jbergstroem]

I've stiched it all together in this preview branch (requires orchestration here, docs repo, mintlify): https://topsort-chore-new-api-docs-openapi-3-1.mintlify.app/api-reference/auctions/create-auctions

..will add output work in above todo.