search

OAI / Arazzo-Specification

The Arazzo Specification - A Tapestry for Deterministic API Workflows
https://spec.openapis.org/arazzo/latest.html
Apache License 2.0
220 stars 44 forks source link

Parameter Object Target Property: JSON Pointer + expression wording together is confusing #85

Closed frankkilcommins closed 11 months ago

frankkilcommins commented 12 months ago

The description is: A JSON Pointer expression identifying locations to inject the value. Can be useful for targeting specific request body part.

I haven't seen JSON Pointer + expression wording together before.

Even the rfc6901 doesn't refer to the JSON Pointer string as expression

char0n commented 12 months ago

Type definition for target fixed field was a bit confusing to me. The type is defined as {JSON Pointer} and not as string. I'd rather have string type there and be guided by field description what the string value represents.