Arazzo Runtime expression escaping

[char0n]

Hi @frankkilcommins,

I'm thinking of the corner case around section https://spec.openapis.org/arazzo/v1.0.1.html#requestbody-object-example, specifically Request Body Object.payload field. The filed is defined as Any but can contain Runtime expressions inside it. This might introduce ambiguity in a case where my data looks like a Runtime expression:

 contentType: application/json
  payload: 
    petOrder:
      petId: $inputs.pet_id # I want this not be evaluated as runtime expression 
      couponCode: $inputs.coupon_code
      quantity: $inputs.quantity
      status: placed
      complete: false

What I mean is that sometimes data might be looking like runtime expressions, but it's just a data. IMHO this mixing introduces ambiguity which is hard to get out of.

What do you think?

[frankkilcommins]

@char0n I guess the same concern might apply in the following locations too:

• Parameter Object > value
• Payload Replacement Object > value

I imagine would could assume that if a $ is specified and it's not indicating a runtime expression then the value must be a string. If so then perhaps we could recommend "$" for literal unevaluated value and "{$}" or $ when it's an explicit expression.