Swagger не генерирует ресурсы @Api

Question

Я пытаюсь интегрировать Swagger для документирования моего REST API. Я следовал этому руководству дословно: http://jakubstas.com/spring-jersey-swagger-configuration/, и он работает peroperly. Я вижу:

{ 
    apiVersion: "1.0", 
    swaggerVersion: "1.2" 
} 

Теперь я хочу, чтобы зарегистрировать одну конечную точку:

@Path("endpoint") 
@Api(value = "/endpoint", description = "My first documented endpoint") 
public class MyEndpoint { 
    //METHODS 
} 

Но когда я перейти к api-doc URL, он по-прежнему возвращает то же самое:

{ 
    apiVersion: "1.0", 
    swaggerVersion: "1.2" 
} 

Мой конечной ресурс находится внутри правильной упаковки. Что я делаю не так?

Спасибо.

Answer 1

Решено. Я добавил @ApiOperation по моему методу @GET и теперь работает. Это необходимо, по крайней мере, для одной операции, чтобы Swagger мог ее документировать.