En cette après midi de novembre, à l’écoute des revendications des gilets jaunes, j’ai voulu prendre un peu de temps pour voir si des sites web pornos proposaient des API. Mauvaise nouvelle, je n’ai vu que du XML, même pas une image ! (Non, le XML n’excite pas forcément un informaticien).
Mais trêve de plaisanterie, passons à l’analyse de cette API.

La doc :
Vous pourrez retrouver la doc à l’URL https://www.eporner.com/api/. Pour les plus prudes, aucune image porno ni vidéo n’est présente ici à la date où j'écris cette article.

Deux endpoints sont fournis par eporner :

• la recherche par mots clefs

• la recherche par documents les plus populaires.

1. La recherche par mots clefs

 L’endpoint fonctionne de la manière suivante :

https://www.eporner.com/api_xml/KEYWORDS/NUMBER_OF_MOVIES

 Les paramètres sont KEYWORDS et NUMBER_OF_MOVIES

• KEYWORD : mot clef thématique de recherche. En remplaçant ce mot-clef par "all" (sans les guillemets), tous les résultats seront renvoyés.
  
• NUMBER_OR_MOVIES : nombre de vidéos revoyées.
  

Testons cette recherche : on va utiliser une recherche des 3 documents BDSM les plus récents :

https://www.eporner.com/api_xml/BDSM/3

On récupère un résultat de ce type :

2. Affichage des vidéos les plus populaires

Le endpoint des vidéos est légèrement différent mais tout aussi simple :

https://www.eporner.com/api_xml/popular/NUMBER_OF_MOVIES/

Le paramètre NUMBER_OF_MOVIES est un nombre de résultats à renvoyer afin de retourner les N vidéos les plus populaires de eporner.
Le retour en XML est le suivant (avec 2 comme NUMBER_OF_MOVIES)

Tout comme le point précédent; il est possible, dans l'URL, de rajouter 2 paramètres : START_FROM/ORDER_BY. On aurait donc :

https://www.eporner.com/api_xml/popular/NUMBER_OF_MOVIES/START_FROM/ORDER_BY

Ces deux paramètres peuvent prendre comme valeurs :

• START_FROM : un nombre symbolisant la N^ième video a partir de laquelle lancer le recherche
• ORDER_BY : champs sur lesquels trier des résultats. Seuls deux résultats sont possible : "adddate" et "id".

Amusez vous bien (avec les API évidemment, loin de moi d'autres idées)