Los parámetros de los feeds de Blogger

Cuando hablamos de JSON y las diferentes opciones para leer los datos de nuestro sitio o de cualquier otro, siempre nos referimos a los feeds y el feed por defecto de nuestro blog tiene la siguiente dirección:

http://miblog.blogspot.com/feeds/posts/default

no importa si usamos o no usamos Feedburner ya que este es un servicio que los "gerencia" pero el feed es siempre el mismo y lo genera Blogger.

Eventualmente, también se accede a él desde otra URL:

http://www.blogger.com/feeds/blogID/posts/default

blogID es un número que podemos ver en la  barra de recciones del navegador cuando accedemos al escritorio; por ejemplo:

http://www.blogger.com/posts.g?blogID=12345678

Los feeds de Blogger tienen un API y por lo tanto, podemos agregar parámetros (query) y, de ese modo, especificar lo que queremos que nos muestre, de este modo lo limitamos o filtramos ciertos datos.

La sintaxis para todos los parámetros ellos es siempre la misma, el primero se coloca antecediéndolo con el carácter ? y si hay más, se adicionan con el carácter & o & si es que los ponemos directamente en la plantilla.

http://miblog.blogspot.com/feeds/posts/default?parametro=valor&parametro=valor

En principio, el orden de esos parámetros es indistinto y el API de Blogger admite los siguiente:

alt indica el formato

• alt=atom es el formato por defecto
• alt=rss lo muestra en formato RSS 2.0
• alt=json lo muestra en formato JSON

estos otros se usa para leerlos mediante JavaScript:

• alt=json-in-script
• alt=atom-in-script
• alt=rss-in-script

y este otro, simplemente lo describe:

• alt=atom-service

category es el parámetro que nos permite leer una etiqueta individual

http://miblog.blogspot.com/feeds/posts/default?category=NOMBRE

o bien:

http://miblog.blogspot.com/feeds/posts/default/-/NOMBRE

a diferencia de otros API del mismo Google, en Blogger no parece haber forma de combinar etiquetas o excluirlas.

max-results establece la cantidad máxima de resultados a ser leidos (por defecto 25) y su valor máximo es 500. Esto devolvería las últimas cinco entradas:

http://miblog.blogspot.com/feeds/posts/default?max-results=5

y esto, las últimas 10 en la categoría NOMBRE:

http://miblog.blogspot.com/feeds/posts/default/-/NOMBRE?max-results=10

orderby ordena los resultados y la verdad, las diferencias entre los valores parecen algo confusas; puede ser:

• lastmodified (es el valor por defecto)
• starttime
• updated

start-index nos permite cargar los datos a partir de un determinado lugar; por defecto, el valor es 1 y es el parámetro que podríamos utilizar para "paginar" algo:

esto leería las últimas 20 entradas:

http://miblog.blogspot.com/feeds/posts/default?start-index=1&max-results=20

esto leería las 20 entradas siguientes:

http://miblog.blogspot.com/feeds/posts/default?start-index=21&max-results=20

published-min y published-max establecen los límites entre fechas de publicación que deben ser escritas en formato RFC 3339 algo que no es sencillo de hacer aunque hay algunos scripts que nos ayudan. Esto, leería los feeds del mes de diciembre del 2010:

http://miblog.blogspot.com/feeds/posts/default?published-min=2010-12-01T00:00:00&published-max=2010-12-31T23:59:59

updated-min, updated-max son similares a lo anterior pero, debe agregarse que el orden sea updated (sigo diciendo que no tengo idea de la diferencia):

http://miblog.blogspot.com/feeds/posts/default?updated-min=2010-12-01T00:00:00&updated-max=2010-12-31T23:59:59&orderby=updated

callback es utilizado cuando el prámetro alt es por json-in-script para indicar el nombre de la función a ser ejecutada

http://miblog.blogspot.com/feeds/posts/default?callback=mifuncion

Así como hay feeds pare entradas, también los hay para los comentarios y, ene se caso, la URL es la siguiente:

http://miblog.blogspot.com/feeds/comments/default

o bien:

http://www.blogger.com/feeds/blogID/comments/default

siendo válidos las mayorias de los parámetros anteriores.

Si quisiéramos leer los comentarios de una entrada específica deberíamos usar el ID del post que es el que vemos cuando lo editamos:

http://miblog.blogspot.com/feeds/1075572725338955545/comments/default