Использует ли Swagger/RAML (или любую аналогичную спецификацию API REST API) асинхронные обратные вызовы клиентов REST?

Question

Я хочу использовать REST асинхронной клиента обратного вызова, то есть сервер вызывает операцию обратного вызова, который будет вызван на стороне клиента, когда ответ готов (см Jersey's 'Asynchronous Services and Clients', чтобы получить то, что я имею в виду)

Могу ли я выразить это в Swagger/RAML/что-то подобное, и наслаждаться соответствующим генерации кода сервера/клиента, генерации документации и т. Д.? Можете ли вы указать на соответствующие примеры/ресурсы?

Answer 1

OAS (ранее Кураж) считал:
https://github.com/OAI/OpenAPI-Specification/issues/716
https://github.com/OAI/OpenAPI-Specification/issues/737
и даже слили callback feature и приземлился в OAS 3.0.
Но инструменты, которые я использовал, похоже, не поддерживают добавление на данный момент.

Answer 2

Что касается OAS 3.0, насколько я помню. Так что еще нет инструмента, который поддерживает эту функцию.