Como definir respostas diferentes para o mesmo código de status HTTP no OpenAPI (Swagger)?
Estou escrevendo uma especificação OpenAPI para uma API existente. Essa API retorna o status 200 para êxito e falha, mas com uma estrutura de resposta diferente.
Por exemplo, na API de inscrição, se o usuário se inscreveu com êxito, a API envia o status 200 com o seguinte JSON:
{
"result": true,
"token": RANDOM_STRING
}
E se houver um usuário duplicado, a API também enviará o status 200, mas com o seguinte JSON:
{
"result": false,
"errorCode": "00002", // this code is duplicated error
"errorMsg": "duplicated account already exist"
}
Nesse caso, como definir a resposta?