Perhaps worth considering something like
https://www.asyncapi.com/docs
for standard way to specify the protocol.
I'm not sure if this is actually worth it, but probably should at least look into it as following a standard may be useful in generating api documentation, automated testing and interaction with tools, etc.