Как я могу сгенерировать документацию для моего REST API Джерси, которая использует привязку JSON JAXB?

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

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

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

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

Ответы на вопрос(4)

Ваш ответ на вопрос