Я использую страницы справки 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
{
}
}
}