E-mail
Attending: Joel Farrell, Dan Rehak, Carl Singer, Valerie Smothers
The group reviewed the MedBiquitous REST web service guidelines. Joel commented that Valerie had filtered an IBM document and added some questions. First the group will go through the questions, then they will discuss what to add.
Carl commented that they should make it clear what JSON is used for and provide a reference where people can find out more. Joel agreed.
Dan asked if we want to tell people that they have to use XML. Joel commented that in this specification yes because for MedBiquitous specs you must be able to support XML.
Note: Valerie made changes to the guidelines as the group went through the document. As results, many comments are not captured in these minutes.
Dan questioned what to do when an access the parameters used. A Web service can have more than one kind of response; which schema do you return? Dan recommended that if there are multiple schemas for a particular request, decide which to use by default. We offer no guidance on how to negotiate that.
With regard to the date and time section and whether to include, Dan commented that a date could be a query. If the date is in the payload, we don't need to say anything because that is regulated by a schema.
Joel commented that because of back and forth interaction, we should leave sections 14 and 15 in. We'll review changes next time and see what else would be helpful to include.
Dan commented that with regard to MedBiquitous and JISC, he could broker an introduction to Sarah Porter for Peter. Sarah is the head of technology and reports to Malcolm Reid. That would be appropriate if we want a formal relationship in place.
We'll discuss versioning on the next call.