Ahora que me he dado cuentaCómo usar JAXB generar JSON Puedo solicitarlo / responder con él en mi servidor y me gustaría averiguar cómo puedo generar documentación útil para los seres humanos que no están utilizando Java. Mi código de servidor se ve así:

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

Todo está bien si alguien está usando Java. Acabo de darles el tarro con elInstanceWithXmlRootElementAnnotation clase en él y dígales que lo envíen (sí, hay un poco más de trabajo, ignora esos detalles).

Si están usando otro idioma, no sé cómo se supone que debo decirles el formato de su carga útil y qué esperar del servidor si devuelve unInstanceWithXmlRootElementAnnotation. ¿Cómo puedo generar documentación que explique el formato esperado de la carga útil de JSON?