Cast Rewinder a une petite API.
Pour tous les développeurs il y a une petite API RESTful accessible via des méthodes GET ou POST.
GET
Le point d’arrivée de l’API est rewind.website/api/get, voici tous les arguments qu’on peut y passer :
url
requis, l’URL du flux, ou l’URL d’un podcast iTunes ou d’une page SoundCloudfrequency
la fréquence accepte les valeurs :monthly
Mensuelweekly
Hebdo valeur par défautdaily
Quotidiencustom_days
Par jour de la semaine
start_date
Date de début accepte des valeurs de dates, utilise aujourd’hui par défaut, format `AAAA-MM-JJ`start_date_timezone
Fuseau horaire de la date de début accepte des valeurs de fuseaux horaires sous la forme d’un TZ name, comme définit sur la liste officielle des fuseaux horaires. Ex. :America/Los_Angeles
ouEurope/Isle_of_Man
(les espaces dans les noms sont remplacées par des “_”) valeur par défaut “Etc/UTC”, soit UTC+00:00option_start_at
Option d’épisode de départ accepte des nombres entiers positif, utilise 1 par défautoption_order
Option d’ordre de diffusion accepte les valeurs :asc
ordre ascendant valeur par défautdesc
ordre descendant
option_format
Option de format du flux accepte les valeurs :feed_rss
valeur par défautfeed_atom
feed_json
option_keepdates
Option pour garder les dates originelles de publication accepte les valeurs :false
valeur par défauttrue
Si la valeur de frequency
est réglée sur custom_days
, il faut fournir un argument pour chacun des jours sélectionnés, sans quoi la fréquence est réglée à Hebdo par défaut.
custom_day_mon=y
pour publier les lundicustom_day_tue=y
pour publier les mardicustom_day_wed=y
pour publier les mercredicustom_day_thu=y
pour publier les jeudicustom_day_fri=y
pour publier les vendredicustom_day_sat=y
pour publier les samedicustom_day_sun=y
pour publier les dimanche
Voici deux exemples :
- Requête basique : rewind.website/api/get?url=https://itunes.apple.com/us/podcast/99-invisible/id394775318
- Requête complexe : rewind.website/api/get?url=https://itunes.apple.com/us/podcast/99-invisible/id394775318&frequency=custom_days&custom_day_mon=y&custom_day_tue=y&custom_day_sun=y&start_date=2018-07-01&start_date_timezone=Europe/Paris&option_start_at=1&option_order=desc&option_format=feed_atom&option_keepdates=true
POST
Le point d’arrivée de l’API est rewind.website/api/post. La requête doit être envoyée au format JSON, avec le type de contenu application/json
. Les arguments sont les mêmes que pour les requêtes en GET.
Voici un exemple de JSON pour une requête en POST, toutes les valeurs passées sont les valeurs par défaut :
{
"url": <ton url>,
"frequency": "custom_days",
"custom_day_mon": false,
"custom_day_tue": false,
"custom_day_wed": false,
"custom_day_thu": false,
"custom_day_fri": false,
"custom_day_sat": false,
"custom_day_sun": false,
"start_date" : <aujourd’hui>,
"start_date_timezone" : "Etc/UTC",
"option_start_at": 1,
"option_order": "asc",
"option_format": "feed_rss",
"option_keepdates": false
}
Réponse
L’API répond à toute requête bien formée par un objet JSON contenant l’ID du feed et son URL complète.
{
"feed_id": 16,
"url": "https://rewind.website/16/mon-tue-sun/20180708+0000"
}
Avec l’ID du flux il est possible de construire ses propres URLs, en suivant les bonnes fréquence, date de début et options.