Как добавить документацию HelpPages для OAuth - PullRequest
0 голосов
/ 31 октября 2019

Я использую страницы справки WebApi для документа, моего API, все в порядке, все контроллеры, расширяющие ApiController, задокументированы.

Я использую OAuth для обработки аутентификации, используя только пароль и токен обновленияgrant.

Как добавить пути OAuth (токен, авторизация и т. д.) в документацию HelpPages?,

Понятия не имею, как это сделать, я не хочу использоватьSwagger.

Я видел, что существует файл с именем Microsoft.Owin.Security.OAuth.XML, но добавление этого файла в WebApiConfig и настройка DocumentProvider должны работать? Я пробовал это, но ничего не происходит. ..

Это мой файл WebApiConfig.cs:

public static class WebApiConfig
{
    public static void Register(HttpConfiguration config)
    {
        config.SuppressDefaultHostAuthentication();
        config.Filters.Add(new HostAuthenticationFilter(OAuthDefaults.AuthenticationType));
        config.Filters.Add(new GeneralExceptionFilterAttribute());

        config.MapHttpAttributeRoutes();

        config.Routes.MapHttpRoute(
            name: "DefaultApi",
            routeTemplate: "api/{controller}/{id}",
            defaults: new { id = RouteParameter.Optional }
        );

        var jsonFormatter = config.Formatters.OfType<JsonMediaTypeFormatter>().First();
        jsonFormatter.SerializerSettings.ContractResolver = new CamelCasePropertyNamesContractResolver();

        try
        {
            config.SetDocumentationProvider(new XmlDocumentationProvider(HttpContext.Current.Server.MapPath("AwesomeApi.xml")));
        }
        catch
        {
        }
    }
}
Добро пожаловать на сайт PullRequest, где вы можете задавать вопросы и получать ответы от других членов сообщества.
...