I personally think (and I believe IC-SC had previously
agreed) that one of the transport mechanisms be a HTTPS REST API. I
recommend the IC-SC begin to draft such a specification and I would
agree to be a co-editor of that spec if desired.
I recommend the HTTPS REST API be specified using another existing standard - OpenAPI (
https://www.openapis.org/).
I believe we should use OpenAPI V2 since V3 is still being worked (but
switch to V3 once it is available). OpenAPI specifications can written
in JSON or YAML - I recommend we use JSON since it would be weird (but I
guess allowed) to write a YAML spec on how to send JSON. Note code
generation for OpenAPI specified API's exist in over 40 languages, and
OpenAPI is used in many API specifications (Google's probably being the
most well known - I am at a conference at the moment, literally sitting
in talk by Google on their use of OpenAPI, which prompted me to sent
these emails).