Authentification

Toutes les requêtes API nécessitent une clé API valide dans le header Authorization.

Obtenir ta clé API

Va dans Settings > API dans le dashboard Finseo
Clique sur Create API Key
Choisis un nom, des scopes et, en option, une restriction à des projets spécifiques
Copie la clé immédiatement — elle ne s’affiche qu’une seule fois

Utiliser ta clé

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.finseo.ai/v1/projects

import requests

headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(
    "https://api.finseo.ai/v1/projects",
    headers=headers
)

const response = await fetch("https://api.finseo.ai/v1/projects", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});

Vérifier une clé

GET /v1/me renvoie le compte auquel appartient une clé. Utilisez-le pour vérifier qu’une clé est valide, indiquer aux utilisateurs quel compte ils ont connecté et lire les scopes de la clé : il répond indépendamment du fait que le compte possède ou non des projets, ce qui en fait l’endpoint approprié pour les intégrations et les tests de connexion.

curl -H "Authorization: Bearer YOUR_API_KEY" https://api.finseo.ai/v1/me

{
  "data": {
    "id": "6a81e088f8ef06e062c40633",
    "email": "you@example.com",
    "accountName": "Your Company",
    "tier": "Business",
    "projectCount": 1,
    "scopes": ["read", "write"],
    "environment": "live"
  }
}

Une clé invalide ou révoquée renvoie 401 avec le code d’erreur UNAUTHORIZED.

Scopes

Les clés API peuvent avoir un ou plusieurs scopes :

Scope	Description
`read`	Lire les données (projets, prompts, métriques, concurrents, sources)
`write`	Modifier les données (créer des prompts, mettre à jour des tags, gérer des projets)
`export`	Export en masse des données de tracking

Restrictions de projet

Tu peux, en option, restreindre une clé à des projets spécifiques. Une clé sans restriction de projet peut accéder à tous les projets de ton compte.

Sécurité des clés

N’expose jamais de clés API dans du code côté client ou des dépôts publics.

Les clés sont hachées avec SHA-256 avant stockage — nous ne stockons jamais de texte en clair
Fais tourner tes clés régulièrement et révoque immédiatement les clés compromises
Utilise des clés de test pour le développement, des clés live pour la production

Vue d'ensemble

Prise en main

Analytics

Authentification de l'API et clés API

Authentification

Obtenir ta clé API

Utiliser ta clé

Vérifier une clé

Scopes

Restrictions de projet

Sécurité des clés

​Authentification

​Obtenir ta clé API

​Utiliser ta clé

​Vérifier une clé

​Scopes

​Restrictions de projet

​Sécurité des clés

Authentification

Obtenir ta clé API

Utiliser ta clé

Vérifier une clé

Scopes

Restrictions de projet

Sécurité des clés