Теперь, когда я понял,как использовать JAXB генерировать JSON Я могу запросить / ответить с ним на моем сервере, и я хотел бы выяснить, как я могу генерировать полезную документацию для людей, которые не используют Java. Мой код сервера выглядит так:

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

Это хорошо, если кто-то использует Java. Я просто дал им банку сInstanceWithXmlRootElementAnnotation класс в нем и скажите им, чтобы отправить его (да, есть немного больше работы, игнорировать эти детали).

Если они используют какой-то другой язык, я не знаю, как я должен сообщить им формат их полезной нагрузки и что ожидать от сервера, если он возвращаетInstanceWithXmlRootElementAnnotation, Как я могу сгенерировать документацию, которая объясняет ожидаемый формат полезной нагрузки JSON?