Change exchangeId to id in exchange creation response

[kezike]

I noticed that the exchange creation endpoint section specifies an exchangeId property in the response. I believe this should be id (this issue is an exchange analog to this workflow issue)?

[dlongley]

Yes, I believe there's an error here. The general rule is that the key name should be id if it is scoped within the exchange itself and exchangeId if it is not within the exchange object itself but is being referenced by some other object.

The exchange creation endpoint should return a location header with the exchange ID as its value and either return a 204 response code (no content) or a 200 with the exchange information, whereby the exchangeId key should be id as stated above. Alternatively, the exchange could be returned underneath an exchange property to allow for other metadata to be returned -- this might be better. Either way the id key name would be used inside the exchange object.