Estou testando o API Blueprint e encontrei algumas coisas que não são claras para mim.

1. Como posso documentar os parâmetros do corpo do POST?

Há sim+ Parameters mas apenas documenta os parâmetros de consulta. Se agora quero descrever uma API do POST, não posso documentar os parâmetros do POST (application / x-www-form-urlencoded). O mesmo vale para o JSON (consulte o item 3).

2. Existe uma maneira de adicionar uma descrição a uma resposta?

eu tentei

+ Response 403
If the request request is made with HTTP instead of HTTPS.

Mas isso apenas adiciona o texto como a resposta do corpo.

3. Descreva os diferentes campos da minha resposta

Se eu retornar JSON, quero descrever cada campo separadamente, seu tipo e seu objetivo. Existe uma maneira de fazer isso?

Obrigado!