irrepressible.info API and RSS
Le site irrepressible.info comporte une puissante API qui peut être utilisée pour construire des applications personnalisées à l’aide de la base de données de contenus «irrepressible», que celle actuellement utilisée pour nos bannières.
Comment utiliser l’API
Vous trouverez l’API sur: http://irrepressible.info/query
Elle renvoie par défaut un xml. personnalisé facile à comprendre. Elle utilise les paramètres suivants, que vous pouvez combiner librement. Les paramètres omis prennent une valeur par défaut ou aucune valeur.
| parameter | values | description |
| lang | "en", "es", "ar", "fr" | pour spécifier la langue dans la description de site (pas le fragment) |
| limit | "all", [integer] (default 10) | pour limiter le nombre d’objets envoyésreturned |
| random | "false" (default), "true" | pour envoyer les résultats dans un ordre aléatoire. Pour que cela fonctionne correctement, il doit être associé au paramètre «limit» afin que le nombre d’objets envoyés soit inférieur au nombre total de ceux qui correspondent à la requête. |
| country | [keywords] | pour filtrer les résultats par pays contenant un ou plusieurs des mots-clés fournis |
| domain | [keywords] | pour filtrer les résultats par domaine contenant un ou plusieurs des mots-clés fournis |
| organisation | [keywords] | pour filtrer les résultats par organisation contenant un ou plusieurs des mots-clés fournis |
| description | [keywords] | pour filtrer les résultats par description contenant un ou plusieurs des mots-clés fournis |
| fragment | [keywords] | pour filtrer les résultats par fragment contenant un ou plusieurs des mots-clés fournis |
| format | "XML" (default), "RSS" | format des résultats envoyés |
Requêtes
- 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
Logique des requêtes complexes
http://irrepressible.info/auery?lang=es&country=china+iran&description=derechos+humanos recherche les fragments censurés en Chine OU en Iran, dont la description de site contient toutes les combinaisons avec «derechos» OU «humanos». Les paramètres pour chaque mot-clé sont liés par l’opérateur logique OU mais les mots-clés sont liés par l’opérateur ET.
Comment utiliser la spécification de langue
La langue spécifiée dans le paramètre «lang» s’applique également au texte recherché. Ainsi, si vous fixez «lang=es» et lancez une recherche avec «description=humanity», vous n’obtiendrez probablement rien. Procédez en revanche comme indiqué ci-dessous:
- http://irrepressible.info/query?lang=en&description=humanity
- http://irrepressible.info/query?lang=es&description=humanity
- http://irrepressible.info/query?lang=es&description=humanidad
Fils RSS avancés
En choisissant le format «RSS» vous pouvez reformater toutes les requêtes imaginables en un fil RSS 2.0 valide. Utilisez-le pour construire un fil personnalisé à utiliser avec des applications RSS compatibles – par exemple un fil RSS avec China et Iran.
Irrepressible.info propose également un fil RSS 2.0 des différents sites censurés répertoriés dans la base de données. Le fil RSS est disponible en anglais, en espagnol, en français et en arabe et il envoie chaque jour un groupe de 10 extraits choisis de manière aléatoire.
Si vous voulez avoir plus de liberté mais avez tout de même besoin d’un fil RSS, vous pouvez également transformer tout résultat fourni par l’API en un fil RSS valide. Pour plus de précisions, veuillez consulter les informations sur l’API figurant à gauche.
