Jetzt, wo ich es herausgefunden habeWie benutzt man JAXB um JSON zu generieren Ich kann es auf meinem Server anfordern / beantworten und möchte herausfinden, wie ich nützliche Dokumentationen für Menschen erstellen kann, die kein Java verwenden. Mein Servercode sieht folgendermaßen aus:

@POST
@Path("apath")
@Consumes(MediaType.APPLICATION_JSON)
public String postAPath(InstanceWithXmlRootElementAnnotation instanceWithXmlRootElementAnnotation) {

Das ist in Ordnung, wenn jemand Java verwendet. Ich gebe ihnen nur das Glas mit demInstanceWithXmlRootElementAnnotation lernen Sie es und bitten Sie sie, es zu senden (ja, es gibt noch ein bisschen Arbeit, ignorieren Sie diese Details).

Wenn sie eine andere Sprache verwenden, weiß ich nicht, wie ich ihnen das Format ihrer Nutzlast mitteilen soll und was sie vom Server erwarten sollen, wenn eine zurückgegeben wirdInstanceWithXmlRootElementAnnotation. Wie kann ich Dokumentation generieren, die das erwartete Format der JSON-Nutzdaten erläutert?