fix(api): Actually order body params by required vs optional

[schew2381]

Closed in favor of manual dereferencing in: #57639
There were concerns about the jsonrefs package and it's actually quite simple to manually dereference

Previously, this ordering silently failed because the request body schema we were fetching only had a reference to it's actual key-value pairs. At the very start of the hook, we now replace all references with a lazy lookup object, which will replace the reference with the real key-value pairs when called upon.

See jsonref documentation for more info

[sentaur-athena]

Neat!

[JoshFerge]

I would also be interesting explroring dropping dereferencing. i'm not sure if we actually have to do that.

[schew2381]

I would also be interesting explroring dropping dereferencing. i'm not sure if we actually have to do that.

Is it drf-spec that's automatically dereferencing or something else internally?

[JoshFerge]

here:

sentry/api-docs/index.ts

Line 32 in 8a7b2b8

return JsonRefs.resolveRefs(root, options).then(

You could also consider modifying that code, it may be easier to do that than to add a new python library. and yes, can see if it would make sense not to derference the JSON.