API

Branchez vos finances à vos propres outils

L'API Winvestam donne accès en lecture et en écriture à vos comptes, catégories et transactions, pour construire vos propres rapports ou automatiser votre suivi financier.

    Connexion sécurisée Lecture et écriture Disponibilité continue
Requête API

GET /transactions

Réponse

{
"statut": "ok",
"compte": "courant",
"solde": 1340,
"devise": "CHF",
"transactions": 24,
"derniere_sync": "il y a 2 min"
}

Démarrer avec l'API

Trois étapes simples suffisent pour passer votre première requête depuis votre propre outil

  1. Choisir un abonnement premium

    L'accès à l'API est réservé aux comptes premium, activable depuis votre espace personnel en quelques clics.
  2. Générer un jeton personnel

    Créez un jeton d'accès depuis votre tableau de bord, propre à votre compte et révocable à tout moment.
  3. Envoyer votre première requête

    Utilisez ce jeton dans l'en-tête de votre requête pour lire ou écrire vos premières données.

Données accessibles via l'API

Chaque point d'accès correspond à une donnée que vous gérez déjà dans l'application

Transactions

Consultez ou ajoutez des transactions associées à un compte et une catégorie donnée.

  • Filtrage par date
  • Filtrage par catégorie
  • Écriture possible

Comptes

Récupérez la liste de vos comptes, leur solde actuel et leur devise de référence.
  • Solde en temps réel
  • Plusieurs devises
  • Lecture seule

Catégories

Accédez à vos catégories de dépenses et de revenus avec leurs limites associées.
  • Hiérarchie simple
  • Limites mensuelles
  • Création possible

Budgets

Consultez vos budgets définis par catégorie et leur progression sur la période en cours.
  • Suivi en pourcentage
  • Période ajustable
  • Alertes de dépassement

Paiements récurrents

Listez vos abonnements et factures récurrentes avec leur prochaine date d'échéance.

  • Fréquence personnalisée
  • Prochaine échéance
  • Historique complet

Concepts clés de l'API

Quelques principes à connaître avant d'intégrer l'API dans votre propre outil
  • Pagination

    Les résultats longs sont découpés en pages de taille raisonnable pour garder des réponses rapides et légères.

    • Taille de page ajustable
    • Curseur de continuation
    • Réponses allégées
  • Filtrage

    Affinez chaque requête par date, catégorie ou compte pour ne récupérer que les données utiles.

    • Filtres combinables
    • Syntaxe simple
    • Paramètres documentés
  • Limites d'usage

    Un plafond de requêtes par minute protège la stabilité du service pour l'ensemble des utilisateurs.
    • Plafond par minute
    • Compteur visible
    • Délai d'attente clair
  • Écritures groupées

    Envoyez plusieurs transactions en une seule requête pour synchroniser rapidement un import volumineux.
    • Jusqu'à cent lignes
    • Réponse détaillée
    • Erreurs isolées par ligne

Bon à savoir

Quelques précisions utiles avant d'intégrer l'API dans un script ou un outil existant
  • Conversion de devise

    Les montants en devise étrangère sont convertis selon un taux indicatif, visible dans chaque réponse de transaction.

    Devises
  • Totaux et tri

    Les totaux par catégorie sont calculés côté serveur et peuvent être triés par montant ou par date.

    Rapports
  • État de synchronisation

    Chaque compte indique un horodatage de dernière synchronisation pour vérifier la fraîcheur des données.
    Synchronisation
  • Réussite partielle

    Lors d'un envoi groupé, certaines lignes peuvent échouer sans bloquer les autres, chaque erreur est détaillée.
    Écritures
  • Rotation du jeton

    Régénérez votre jeton d'accès à tout moment sans interrompre les autres connexions actives sur votre compte.
    Sécurité

Exemples d'intégration

Quatre façons concrètes d'utiliser l'API selon l'outil que vous avez déjà en main

Terminal

Récupérez vos dix dernières transactions directement depuis une invite de commande standard.
curl https://winvestam.pro/api/transactions
-H "Authorization: Bearer votre_jeton"
-G -d limit=10

Tableur

Importez vos transactions mensuelles dans une feuille de calcul sans copier-coller manuel.
Ouvrir Données puis Importer depuis le web
Coller l'URL de l'endpoint transactions
Ajouter le jeton dans l'en-tête de requête
Actualiser la feuille chaque matin

Tableau de bord

Connectez un outil de visualisation à vos données pour suivre vos dépenses en temps réel.

Créer une nouvelle source de données
Sélectionner le type API REST
Renseigner l'endpoint et le jeton
Choisir un rafraîchissement toutes les heures

Script d'analyse

Écrivez un script simple qui calcule vos dépenses moyennes par catégorie chaque semaine.

reponse = requete_api("/transactions")
donnees = reponse.json()
calculer_moyenne_par_categorie(donnees)

Consultez la documentation complète

Retrouvez chaque point d'accès, ses paramètres et des exemples de réponses détaillés pour démarrer sereinement.
    Sans engagement Documentation à jour Support technique