Thanks for your answer but as I mentionned, I already looked at the documentation :
I’m looking for the yaml specification … like Open API in order to write the right client or generate it using the swagger online editor :
I guess it’s not available “yet”