Jak mogę wygenerować dokumentację dla mojego Jersey REST API, który używa wiązania JSON JAXB?

Teraz, gdy się zorientowałemjak używać JAXB generować JSON Mogę zażądać / odpowiedzieć na mój serwer i dowiedzieć się, jak mogę wygenerować użyteczną dokumentację dla ludzi, którzy nie używają Javy. Mój kod serwera wygląda tak:

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

To dobrze, jeśli ktoś używa Java. Po prostu daję im słoik zInstanceWithXmlRootElementAnnotation w klasie i powiedz im, aby ją przesłali (tak, jest trochę więcej pracy, zignoruj ​​te szczegóły).

Jeśli używają innego języka, nie wiem, jak mam im powiedzieć format ich ładunku i czego oczekiwać od serwera, jeśli zwróciInstanceWithXmlRootElementAnnotation. Jak mogę wygenerować dokumentację wyjaśniającą oczekiwany format ładunku JSON?

questionAnswers(4)

yourAnswerToTheQuestion