Hello.
I am using the DSS REST API through a Java program where I do the HTTP Requests with \Jersey Library.
My question is whether there is an official XSD Schema for the request and response bodies that defines the names and format of the parameters used.
If such schema exists, then where can I find it ?
Reason for my question is that from an XSD Schema, I can easily and automatically generate Java Beans for the request and response bodies and thus have:
- Format checking at compile time. Users cannot put parameters which are outside ot the schema and there is not java setter for them in the Java Bean
- Runtime format validation. Each response is matched to the expected Java Bean and thus verified that its content can be mapped to that bean (has expected format).
- Have clean programming style.
Here is what I actually expect
Event though XSD schema is designed to describe XML, I guess it could perfectly appy for JSON format as well.
So for example a
XML schema for the authentication endpoint:
https://hosted.datascopeapi.reuters.com/RestApi/v1/Authentication/RequestToken
wifh example
body:
{ "Credentials": { "Username": "33314", "Password": "XXXXXXX" } }
Could look like this:
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="Credentials">
<xs:complexType>
<xs:sequence>
<xs:element type="xs:int" name="Username"/>
<xs:element type="xs:string" name="Password"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
Best Regards
Yordan
