ASP.NET Web API Genere todos los parámetros desde el modelo: páginas de ayuda
Estoy ocupado creando una API web (dentro de una aplicación asp mvc4). Estoy usando la biblioteca sugerida en el sitio asp.net para generar documentación (http://www.asp.net/web-api/overview/creating-web-apis/creating-api-help-pages).
Mi problema es que si mi parámetro es un modelo, no puedo especificar qué propiedades contiene el modelo en las páginas de ayuda generadas.
Aquí hay un ejemplo:
MODELO:
public class TestModel
{
property String FirstName {get;set;}
property String Surname {get; set;}
property Boolean Active {get;set;}
}
ACCIÓN:
/// <summary>
/// This is a test action
/// </summary>
/// <param name="model">this is the model</param> <-- this works
/// <param name="FirstName">This is the first name </param> <-- doesn't work
/// <param name ="model.Surname">This is the surname</param> <-- doesn't work
public HttpResponseMessage Post(my.namespace.models.TestModel model)
{
...
}
Sólo se genera el parámetro para el modelo.
Eché un vistazo al documento xml que se genera para la documentación y agrega los otros parámetros.
<member name="my.namespace.api.Post(my.namespace.models.TestModel)">
<summary>
this is a test action
</summary>
<param name="model>this is the model</param>
<param name="FirstName">This is the first name </param>
<param name="model.Surname">This is the surname</param>
</member>
Pero en las páginas de ayuda solo genera el modelo de parámetros.
Lo he rastreado hasta el método donde obtiene los parámetros del xml.
Collection<ApiDescription> apiDescriptions = config.Services.GetApiExplorer().ApiDescriptions;
Esto se encuentra en HelpPageConfigurationExtentions.cs, que se genera automáticamente.
¿Me estoy acercando a esto de la manera incorrecta? ¿Alguien sabe de alguna solución?
Cualquier sugerencia o solución será apreciada.