Should the spec be more specific about Content-Type header?

openservicebrokerapi / servicebroker

Open Service Broker API Specification

https://openservicebrokerapi.org/

Apache License 2.0

1.19k stars 434 forks source link

Should the spec be more specific about Content-Type header? #543

Closed williammartin closed 6 years ago

williammartin commented 6 years ago

I notice a bunch of the example curl requests on the spec set the Content-Type to application/json. Is this actually part of the specification and if so, should we make that explicit somewhere?

duglin commented 6 years ago

wow - how did we miss that? ;-) want to open a PR?

Maybe we should create a new top-level section for "HTTP Headers" and put the version header, originating identity header and this new one under there as sub-sections?

williammartin commented 6 years ago

Sure I'll open a PR and we can chat. Not sure I want to put this together with OSBAPI specific headers quite yet but maybe we could refactor later if it looks like they should be. Will do the simple thing first.