A continuación describimos las llamadas a la API para obtener información referente a las categorías.
En todos los métodos explicados se puede añadir un parámetro numérico opcional que indica la profundidad de las categorías que quieres consultar. Por ejemplo, si queremos listar sólo las categorías principales, le asignaremos el valor "0" (si no lo ponemos, ése es el valor que nos dará por defecto); si queremos las categorías principales y un primer nivel de subcategorías, le daremos el valor "1", y análogamente. En los ejemplos veréis claramente cómo aplicar este parámetro opcional.
Os recordamos que SIEMPRE debéis incluir la
ApiKey. (NOTA: En los ejemplos se da un ApiKey no válida)
Editar/categories
- Descripción: Listado de categorías.
- Ejemplo de llamada (profundidad 0 por defecto): http://api.todoexpertos.com/v1/categories?apikey=1234
- Ejemplo de llamada (le asignamos una profundidad de 1): http://api.todoexpertos.com/v1/categories/1?apikey=1234
- Ejemplo de respuesta:
<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0" xmlns:te="http://www.todoexpertos.com/api/te">
<channel>
<title>GetCategoryTree</title>
<description>Devuelve el árbol de categorías de Todoexpertos</description>
<link>http://api.todoexpertos.com/category/[categorypath]/[?categorydepth]</link>
<item>
<title>Título de la categoría</title>
<te:categorypath>Path de la categoría</te:categorypath>
<te:categoryurl>Url de la categoría</te:categoryurl>
</item>
</channel>
</rss>
Editar/categories/categorypath
- Descripción: Listado de categorías.
- Ejemplo de llamada (profundidad 0 por defecto): http://api.todoexpertos.com/v1/categories/categorypath?apikey=1234
- Ejemplo de llamada (le asignamos una profundidad de 1): http://api.todoexpertos.com/v1/categories/categorypath/1?apikey=1234
- categorypath: path de la categoría desde la que se listarán subcategorías.
- Ejemplo de respuesta: el RSS devuelto es el mismo que para el caso anterior.