Intégrer le contenu publié et les métadonnées d’Omny Studio dans les lecteurs Web et mobiles
Les API grand public d’Omny Studio permettent à des tiers d’intégrer des métadonnées sur le contenu publié dans des lecteurs personnalisés et des répertoires de contenu sur un site Web ou une application mobile.
Seul le contenu publié publiquement sera disponible dans l’API grand public. Les programmes cachés, les clips privés ou les listes de lecture privées ne seront pas accessibles.
Remarque : « l'API consommateur » est une API en lecture seule. Pour créer, modifier ou supprimer du contenu, « l’API de gestion »permet un accès administratif privé à l’organisation.
Analyses
Si vous souhaitez suivre le nombre de lectures/téléchargements effectués à partir de vos lecteurs personnalisés, vous pouvez définir et effectuer un suivi des sources personnalisées.
Si vous souhaitez suivre les données de consommation des lectures sur des lecteurs personnalisés, vous pouvez envoyer des événements de lecteur à l’aide de l’API d'analyse de données de consommation d’Omny Studio.
Cache
Les réponses sont mises en cache pendant une durée allant jusqu’à 10 minutes. Les mises à jour des métadonnées du clip peuvent ne pas être répercutées tant que le cache n’est pas actualisé.
CORS
Les requêtes CORS sont autorisées à partir de n’importe quel domaine.
Pour des performances optimales de l’API, nous vous recommandons d’effectuer des « requêtes simples » (c’est-à-dire de ne pas spécifier d’en-têtes HTTP personnalisés) pour éviter de déclencher une demande de contrôle en amont CORS.
Limites de débit
Il n’y a pas de limite de débit pratique pour cette API. Cependant, notre pare-feu d’applications Web Cloudflare peut bloquer le trafic qu’il juge malveillant ou nuisible.
Désactiver le préchargement
Les éditeurs tiers qui créent des lecteurs personnalisés doivent désactiver le préchargement et la lecture automatique de leurs lecteurs pour s’assurer que seule la lecture initiée par l’utilisateur déclenchera un téléchargement à l’aide de preload=none attribut
Documentation
La documentation de l’API est disponible au lien suivant : https://api.omny.fm/docs/consumer-api/