FAQ
1. Démarrer avec l'API
- Comment utiliser l'API Music Story ?
Vous trouverez une documentation complète sur l'utilisation de notre API dans la section documentation du site. Un outil de test y est également à votre disposition permettant de construire directement sa requête en choisissant ses paramètres, et de tester la réponse. Attention : il n'est utilisable qu'une fois connecté.
- Comment commencer à développer ?
Dès votre inscription vous recevrez un mail de confirmation. Après avoir confirmé vous recevrez deux clés API qui vous donneront immédiatement accès à l'API. Attention de bien lire les conditions d'utilisation avant toute utilisation. Vous pourrez trouver dans votre espace personnel les informations relatives à votre type de compte, vos statistiques, ainsi que vos clés API.
- A quoi servent mes clés API ?
Ce sont des clés strictement personnelles qui vous permettent de vous identifier pour ouvrir une session d'utilisation de l'API. Nous vous fournissons deux clés : la consumer key et la consumer secret key.
- Que faire si je rencontre un problème ?
Dès votre inscription vous bénéficiez d'un support par mail ou via notre forum. Vous pourrez ensuite bénéficier d'un support plus rapide et même d'un dédié. Pour cela référez-vous à notre descriptif d'offre.
2. Conditions d'utilisation
3. Réponse de l'API
4. Quotas & restrictions
- Comment connaître le nombre de mes requêtes disponibles restantes ?
Connectez-vous et rendez vous sur votre espace personnel, vous avez accès à toutes les statistiques API vous concernant, en temps réel.
- Qu'est ce qu'un item ?
Les items sont les éléments éditoriaux sujets à droits de diffusion. Ce sont les biographies, chroniques d'albums, news et dans une certaine mesure les photos produites ou acquises par Music Story et accessible par l'API.
Chaque type d'utilisation correspond à une droit de diffusion de ces contenus. Un compteurs du nombre d'Items auxquels vous avez accédé est disponible dans votre espace personnel.
- J'ai dépassé les limites fixées par mon abonnement, que faire ?
Les limites sont réinitialisées le 1er de chaque mois. Il vous faut soit attendre le mois prochain, soit souscrire à un abonnement qui vous permettra d'étendre vos possibilités.
- Le temps de réponse de l'API semble long, a quoi cela est-il dû ?
L'API limite le nombre de requêtes par seconde par utilisateur. Si, toutefois, vous considérez que le temps de réponse dépasse cette restriction, merci de contacter le support.
- Suis-je banni ?
Si vous avez des raisons de penser que vous avez été blacklisté, stoppez toutes vos requêtes en cours et contactez le support afin d'en connaître les raisons, si c'est effectivement le cas. Pour éviter que cela se produise, prenez en considération les conditions d'utilisation avant de profiter de nos services.
5. Données Music Story
- Quelle est la différence entre un album et une release ?
Une release fait référence à un produit identifié par son EAN, de support physique ou digital, qui correspond à une édition d'un album. L'album est un regroupement cohérent de plusieurs éditions correspondant à la compréhension du public de ce qu'est un album.
Exemple : l'album Random Access Memories de Daft Punk regroupe toutes les releases correspondantes (produits EAN).
- Quelle est la différence entre track, recording et work?
Track est une piste soit un élément de la liste des titres d'une release. Recording est un enregistrement identifié par un code ISRC. Il peut correspondre à plusieurs tracks. Work est une oeuvre identifiée par son ISWC (ou COCV)ou sens des droits d'Edition. Une oeuvre donne souvent lien à plusieurs enregistrements (interprétations diffréentes, réenregistrements etc...)
- L'API Music Story peut-elle se substituer à l'API de ses partenaires ou des réseaux sociaux ?
Non. Notre API ne délivre pas de metadonnées partenaires, ni de données propres aux réseaux sociaux. Elle fournit un moyen efficace de lier les artistes, éditions d'album, pistes Music Story à leur équivalent sur une autre plateforme, ou entre plateformes, qui peut vous permettre par la suite d'utiliser les autres APIs à votre disposition.
- A quelles données puis-je avoir accès ?
Toutes. Cependant selon votre type de compte, vous pouvez être limités en nombre de requêtes, ou en nombre d'items, selon le type de données. Ces limitations, et vos requêtes ou objets accessibles restants s'affichent dans votre espace personnel. Pour profiter d'un accès moins restreint, merci de vous réferer à notre descriptif d'offre.
- Quelles sont les autres particularité à connaître ?
Aucune. L'API Music Story est facile d'accès et intuitive. La documentation complète est là pour vous aider.
6. Outils à disposition
