search

OAI / OpenAPI-Specification

The OpenAPI Specification Repository
https://openapis.org
Apache License 2.0
28.82k stars 9.07k forks source link

Label serialization style example does not match RFC 6570 #1956

Closed vvanpo closed 6 months ago

vvanpo commented 5 years ago

The example in the style examples table for label and explode: false uses a period as the exclusive delimiter. This does not match RFC 6570, where the {.list} template results in .blue,black,brown for arrays and .R,100,G,200,B,150 for objects, i.e. the prefix is still a period, but the delimiter is a comma.

At this point, most OpenAPI implementations are probably coded to the example, and not the RFC, so fixing this would be a breaking change. I would suggest patching the 3.0 standard to note the discrepancy.

lornajane commented 6 months ago

Since this long-standing issue has had no activity or engagement for some time, I'm closing it. Please open a new issue if you think there's some action needed with the current version of OpenAPI.