Documentation API QuiDistrib

Ressources et Endpoints pour interroger la base de données QuiDistrib

Authentification : L'accès à l'API nécessite une clé unique (key). Cette clé est strictement personnelle et permet de suivre l'utilisation de votre quota mensuel.

Recherche de Producteurs par Artiste

GET https://api.quidistrib.com/v1/search?key={votre_cle}&artist={nom_artiste}
Description

Cet endpoint permet de rechercher un artiste par son nom et de récupérer les coordonnées détaillées du ou des producteur(s) qui le représentent. Le moteur de recherche interne est permissif et gère les accents intelligemment.

Paramètres d'URL
Exemple de Requête
GET https://api.quidistrib.com/v1/search?key=VOTRE_CLE_SECRETE&artist=Gojira
Exemple de Réponse (Succès)
{
  "success": true,
  "quota_used": 124,
  "quota_limit": 1000,
  "results": [
    {
      "nom_artiste": "Gojira",
      "nom_structure": "Gérard Drouot Productions",
      "address": "37 rue Vivienne, 75002 Paris",
      "phone": "01 44 94 91 50",
      "email": "booking@gdp.fr",
      "website": "https://gdp.fr"
    }
  ]
}
Codes d'Erreurs Communs
Code HTTP Raison (JSON)
401 {"error": "Clé API manquante"} - Vous avez oublié le paramètre key=...
403 {"error": "Clé API invalide"} ou {"error": "Clé API désactivée ou abonnement expiré"}
429 {"error": "Quota mensuel dépassé"} - Vous avez atteint votre limite mensuelle (ex: 1000/1000).
500 {"error": "Erreur de connexion base de données"} - Le serveur de la base de données est injoignable.