irrepressible.info API and RSS
La API de irrepressible.info es potente y permite crear aplicaciones personalizadas con la misma base de datos de contenidos irrepressible, que actualmente se utiliza para activar nuestros banners.
Cómo se usa la API
La API se encuentra en: http://irrepressible.info/query
Por defecto, presenta una xml personalizada de fácil comprensión. Admite los siguientes parámetros, que se pueden combinar a gusto. Los parámetros omitidos simplemente adoptarán un valor por defecto o ninguno.
| parameter | values | description |
| lang | "en", "es", "ar", "fr" | para especificar el idioma de la descripción del sitio (no del fragmento) |
| limit | "all", [integer] (default 10) | para limitar el número de elementos que deben mostrarse |
| random | "false" (default), "true" | para presentar los resultados por orden aleatorio. Para que funcione correctamente, esta función debe combinarse con un parámetro limit (limitación) que limite las entradas mostradas a un número inferior al total disponible que coincide con la consulta. |
| country | [keywords] | para filtrar los resultados por países que contengan una o varias de las palabras clave suministradas |
| domain | [keywords] | para filtrar los resultados por dominios que contengan una o varias de las palabras clave suministradas |
| organisation | [keywords] | para filtrar los resultados por organizaciones que contengan una o varias de las palabras clave suministradas |
| description | [keywords] | para filtrar los resultados por descripciones que contengan una o varias de las palabras clave suministradas |
| fragment | [keywords] | para filtrar los resultados por fragmentos que contengan una o varias de las palabras clave suministradas |
| format | "XML" (default), "RSS" | formato de los resultados presentados |
Consultas
- http://irrepressible.info/query?lang=en&country=china+iran
- http://irrepressible.info/query?lang=en&domain=tibet
- http://irrepressible.info/query?lang=en&organisation=BBC
- http://irrepressible.info/query?lang=en&fragment=year
Lógica de las consultas complejas
http://irrepressible.info/auery?lang=es&country=china+iran&description=derechos+humanos buscará fragmentos censurados en China OR (O) Irán cuya descripción de sitio contenga cualquier combinación de las palabras "derechos" OR "humanos". Las palabras contenidas en cada palabra clave se combinan mediante OR, pero las palabras clave se combinan mediante AND (Y).
Cómo especificar el idioma
El idioma especificado en el parámetro lang (idioma) también gobierna el texto buscado, de modo que si se define el parámetro lang=es y se busca una descripción=humanity, probablemente no se encuentre nada. En su lugar, el parámetro de idioma debe utilizarse de la siguiente manera:
- http://irrepressible.info/query?lang=en&description=humanity
- http://irrepressible.info/query?lang=es&description=humanity
- http://irrepressible.info/query?lang=es&description=humanidad
Canales RSS avanzados
Cuando se elige el formato "rss", es posible convertir el formato de cualquier consulta en un canal RSS 2.0 válido. Utilícese en la creación de un canal personalizado para usar con aplicaciones compatibles con RSS, como por ejemplo un canal RSS de China e Irán.
Irrepressible.info también presenta un canal RSS 2.0 de los diversos sitios censurados que contiene la base de datos. El canal está disponible en inglés, español, francés y árabe, y cada día muestra un juego diferente de extractos escogidos al azar.
Si desean un mayor control pero aún así necesitan un canal RSS, cualquiera de los resultados presentados por la API se puede convertir también en un canal RSS válido. Para más información, consulten los datos sobre la API que figuran a la izquierda.
