Documentation API - Authentification

🔑 Documentation API - Authentification et Tokens

Apprenez comment obtenir et utiliser vos tokens d'accès à l'API FactPulse selon votre méthode d'inscription.

💡 Important : Utilisateurs OAuth (Google/GitHub)

Si vous vous êtes inscrit avec Google ou GitHub, vous n'avez pas de mot de passe défini par défaut. Pour utiliser l'endpoint /api/token/, vous pouvez soit :

✅ Option 1 (recommandée) : Utiliser les tokens générés depuis votre Dashboard
✅ Option 2 : Définir un mot de passe sur votre compte pour utiliser /api/token/

📋 Deux Méthodes d'Authentification

🔐 Méthode 1 : API /api/token/ (RECOMMANDÉ PRODUCTION)

Automatisation complète

Idéal pour :

✅ Automatisation complète (CI/CD)
✅ Scripts côté serveur
✅ Intégrations sans interaction utilisateur

⚠️ Prérequis : Vous devez avoir un mot de passe défini sur votre compte

Obtenir un token :

curl -X POST https://factpulse.fr/api/token/ \
  -H "Content-Type: application/json" \
  -d '{"username": "votre@email.com", "password": "votre_mot_de_passe"}'

Rafraîchir le token :

curl -X POST https://factpulse.fr/api/token/refresh/ \
  -H "Content-Type: application/json" \
  -d '{"refresh": "votre_refresh_token"}'

🎯 Méthode 2 : Dashboard (Tests manuels)

Fonctionne pour TOUS les utilisateurs

Idéal pour :

✅ Utilisateurs inscrits via Google/GitHub (sans mot de passe)
✅ Tests rapides et développement
✅ Démonstrations et prototypes

Comment procéder :

Connectez-vous à votre Dashboard
Cliquez sur "Generate Test Token" ou "Generate Production Token"
Copiez le token affiché

📊 Comparaison des Méthodes

Critère	API /api/token/	Dashboard
Production automatisée	✅ Recommandé	❌ Non adapté
Utilisateurs OAuth	⚠️ Nécessite un mot de passe	✅ Fonctionne directement
Validité du token	Access: 30min, Refresh: 7j	Test: 24h, Prod: 7j
Refresh automatique	✅ Via refresh token	❌ Régénération manuelle

❓ Questions Fréquentes

Je suis inscrit via Google, comment utiliser l'API ?

Deux solutions :

Pour la production : Définissez un mot de passe via ce lien
Pour les tests : Générez vos tokens depuis le Dashboard

Est-ce sécurisé de stocker mon token en dur dans mon code ?

❌ Non, jamais ! Utilisez toujours des variables d'environnement :

# .env
FACTPULSE_API_TOKEN=eyJ0eXAiOiJKV1QiLCJhbGc...

# Python
import os
token = os.getenv("FACTPULSE_API_TOKEN")

Si je définis un mot de passe, puis-je toujours me connecter via Google ?

✅ Oui ! Les deux méthodes coexistent.

🚀 Prêt à intégrer l'API ?

Connectez-vous à votre Dashboard pour générer vos premiers tokens

Accéder au Dashboard

Prêt à intégrer la facture électronique ?

Testez gratuitement notre API en 2 minutes. Sandbox gratuit avec 1000 appels/jour.

🚀 Tester gratuitement 💳 Voir les tarifs

Aucune carte bancaire requise