Guides

Obtenir une liste de podcasts :

Point de terminaison : /api/v2/podcasts/
Méthodes HTTP : GET
Authentification : non requise
Paramètres :
limit : nombre d’enregistrements dans la réponse (facultatif)
offset : décalage, indique l’enregistrement de départ (facultatif)
server : ID du serveur radio (facultatif)

Exemple en Python :

import requests

response = requests.get("https://demoaccount.s02.radio-tochka.com:8080/api/v2/podcasts/?server=1")
print(response.json())

Exemple en PHP avec cURL :

$url = "https://demoaccount.s02.radio-tochka.com:8080/api/v2/podcasts/?server=1";

$ch = curl_init($url);

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// Désactiver SSL si ton environnement pose problème (certificat)
// À retirer en production
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);

$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo "Erreur cURL: " . curl_error($ch);
    curl_close($ch);
    exit;
}

curl_close($ch);

// Afficher le JSON brut
header("Content-Type: application/json");
echo $response;

// OU (sans le header et echo ci-dessus)

// Si vous voulez un tableau PHP décodé :
$data = json_decode($response, true);
print_r($data);

Exemple de sortie :

[
    {
        "id": 2,
        "folder": "the-retro-podcast",
        "image": "https://radio.com:8080/media/podcast_covers/podcast1.jpg",
        "episodes_count": 5,
        "feed_url": "https://radio.com:8080/api/v2/podcasts/2/feed.xml",
        "public_page_url": "https://radio.com:8080/public/podcasts/2/",
        "title": "The Retro Podcast",
        "description": "There are many variations of passages of Lorem Ipsum",
        "published": true,
        "server": 1
    },
]

Description

• folder : dossier du podcast sur le système de fichiers du serveur
• image : image de couverture du podcast
• episodes_count : le nombre d'épisodes de ce podcast
• feed_url : URL du flux RSS de ce podcast
• public_page_url : URL de la page publique de ce podcast, permet de le consulter via un navigateur.
• title : titre du podcast
• description : description du podcast
• published : vrai si le podcast est publié (et non un brouillon).
• server : identifiant du serveur radio auquel appartient le podcast

Créez un podcast sur la radio en spécifiant l'identifiant du serveur. Si vous souhaitez également inclure une image de couverture, envoyez une requête POST avec multipart/form-datal'en-tête correspondant et indiquez l'image via le paramètre `image` :

Point de terminaison : /api/v2/podcasts/
Méthodes HTTP : POST
Authentification : requise
Paramètres :
title : titre du podcast (chaîne de caractères)
published : booléen
description : description du podcast (chaîne de caractères)
server : identifiant du serveur radio

Obtient un seul podcast par son identifiant :

Point de terminaison : /api/v2/podcasts/id/
Méthodes HTTP : GET
Authentification : non requise

Obtient une liste d'épisodes de podcast par identifiant de podcast :

Point de terminaison : /api/v2/podcasts/podcast_id/episodes/
Méthodes HTTP : GET
Authentification : non requise

Obtient un épisode de podcast grâce à son identifiant : 

Point de terminaison : /api/v2/podcasts/podcast_id/episodes/episode_id/
Méthodes HTTP : GET
Authentification : non requise

Télécharger le fichier de l'épisode au format MP3 : 

Point de terminaison : /api/v2/podcasts/podcast_id/episodes/episode_id/episode.mp3/
Méthodes HTTP : GET
Authentification : non requise