Logo FactPulse
🚀 Essayer gratuitement

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
  • ✅ Seule méthode utilisable en production automatisée
⚠️ Prérequis : Vous devez avoir un mot de passe défini sur votre compte

Si vous êtes inscrit par email :

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

Réponse :

{
  "access": "eyJ0eXAiOiJKV1QiLCJhbGc...",  // Validité : 30 minutes
  "refresh": "eyJhbGciOiJIUzI1NiIsInR..."   // Validité : 7 jours
}

Rafraîchir le token :

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

Si vous êtes inscrit via Google/GitHub :

Solution : Définissez un mot de passe pour utiliser cette méthode

Définir un mot de passe
  1. Allez sur Définir un mot de passe
  2. Créez un mot de passe pour votre compte
  3. Vous pourrez ensuite utiliser /api/token/

✨ Vous conserverez toujours la possibilité de vous connecter via Google/GitHub

🎯 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
⚠️ Limitation : Génération manuelle uniquement. Non adapté pour la production automatisée.

Comment procéder :

  1. Connectez-vous à votre Dashboard
  2. Cliquez sur "Generate Test Token" ou "Generate Production Token"
  3. Copiez le token affiché
  4. Utilisez-le dans vos requêtes API

Exemple d'utilisation :

curl -X POST https://api.factpulse.fr/api/v1/conversion \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGc..." \
  -H "Content-Type: application/json" \
  -d '{
    "invoice": {...}
  }'

Caractéristiques des tokens :

Type Validité Quota Facturation
Test 24 heures 1000 appels/jour Gratuit
Production 7 jours Selon votre forfait Facturé

📊 Comparaison des Méthodes

Critère API /api/token/ Dashboard
Production automatisée ✅ Recommandé ❌ Non adapté
Automatisation ✅ Complètement automatisée ⚠️ Génération manuelle
Utilisateurs OAuth ⚠️ Nécessite de définir un mot de passe ✅ Fonctionne directement
Utilisateurs Email ✅ Oui ✅ Oui
Validité du token Access: 30min, Refresh: 7j Test: 24h, Prod: 7j
Refresh automatique ✅ Via refresh token ❌ Régénération manuelle
Sécurité ✅ HTTPS uniquement ✅ Session sécurisée

❓ Questions Fréquentes

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

Deux solutions :

  1. Pour la production (recommandé) : Définissez un mot de passe via ce lien, puis utilisez /api/token/ pour l'automatisation complète
  2. Pour les tests manuels : Générez vos tokens depuis le Dashboard

Puis-je régénérer un token avant son expiration ?

Oui ! Vous pouvez générer autant de tokens que vous voulez. Les anciens restent valides jusqu'à leur expiration.

Que faire si mon token expire pendant une requête ?

Deux options :

  • Méthode API (recommandé) : Utilisez le refresh token pour obtenir un nouveau access token automatiquement
  • Méthode Dashboard : Générez un nouveau token manuellement
curl -X POST https://factpulse.fr/api/token/refresh/ \
  -H "Content-Type: application/json" \
  -d '{"refresh": "votre_refresh_token"}'

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...

# Votre code 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. Vous pourrez :

  • Vous connecter via Google/GitHub (comme avant)
  • Vous connecter via email + mot de passe
  • Utiliser /api/token/ pour l'automatisation

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

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

Accéder au Dashboard Définir un mot de passe

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