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.