Retour au guide de configuration

API publique & MCP

Accès en lecture seule aux métriques, avis et événements d’abonnement de votre organisation. Authentifiez-vous avec une clé API créée dans Réglages → Développeur.

Authentification

Envoyez votre clé API Nicodesk en Bearer. Les sessions cookie ne sont pas acceptées sur /api/v1.

Authorization: Bearer nd_<prefix>_<secret>

Créez et révoquez des clés dans Réglages → Développeur.

Endpoints

  • GET https://app.nicodesk.com/api/v1/me

    Test d’identité : id d’organisation, nom et scopes.

  • GET https://app.nicodesk.com/api/v1/metrics?range=30D&groupBy=day

    Mêmes paramètres que l’API métriques du dashboard : range ou from/to, groupBy, compare, force.

  • GET https://app.nicodesk.com/api/v1/reviews?limit=50&platform=ios

    Jusqu’à 200 avis récents. Filtres : platform, connectionId, bundleId, unanswered=1, maxRating.

  • GET https://app.nicodesk.com/api/v1/events?limit=50

    Jusqu’à 200 événements d’abonnement récents. Filtres : platform, connectionId, bundleId.

Exemple

curl -sS \
  -H "Authorization: Bearer nd_YOUR_KEY" \
  "https://app.nicodesk.com/api/v1/me"

MCP

Le serveur MCP hébergé expose les mêmes outils en lecture. Passez la clé API dans l’en-tête Authorization.

{
  "mcpServers": {
    "nicodesk": {
      "url": "https://app.nicodesk.com/api/mcp",
      "headers": {
        "Authorization": "Bearer nd_YOUR_KEY"
      }
    }
  }
}

Limites

Rate limit soft : environ 120 requêtes par minute et par clé (best-effort en serverless). Avis et événements limités à 200 lignes par requête.