Swagger UI - не в состоянии расширить операции

Я пытаюсь использовать чванство с игровой рамкой.

Я добавил аннотации API в код, и я могу получить к нему доступ через

LOCALHOST:9000/ API-документы

{
    apiVersion: "beta",
    swaggerVersion: "1.2",
    basePath: "http://localhost",
    resourcePath: "/metrics",
    produces: [
      "application/json"
    ],
    apis: [
      {
         path: "/metrics",
         operations: [
            {
              method: "POST",
              summary: "Save metrics",
              ...
              authorizations: { },
              parameters: [ ],
              responseMessages: [
                 {
                    code: 400,
                    message: "Expecting Json data"
                 },
              ]
            }
         ]
      }
   ]
}

Но когда я пытаюсь изучить его с помощью пользовательского интерфейса, я не могу развернуть или перечислить операции.

В пользовательском интерфейсе swagger index.html я внес следующие изменения.

$(function () {
  var url = window.location.search.match(/url=([^&]+)/);
  if (url && url.length > 1) {
    url = url[1];
  } else {
    url = "http://localhost:9000/api-docs";
  }
...

  window.authorizations.add("Accept", new ApiKeyAuthorization("Accept", "application/json", "header"));

Я пропускаю какие-либо конфигурации. Пожалуйста, предоставьте предложения или указатели.

1 ответ

Были две проблемы.

  1. Базовый URL не был настроен должным образом. Я добавил следующее поле в файл conf, чтобы это исправить.

    swagger.api.basepath = "HTTP:// локальный:9000/"

  2. В аннотации ApiOperation есть поле псевдонима. Это требуется. Если поле псевдонима не задано, мы не сможем расширить операции в пользовательском интерфейсе.

Другие вопросы по тегам