API myFund.pl v1
Compatibilité : API myFund.pl v1, URL de base https://myfund.pl/API/v1.
Source : capture de documentation groupée datée du 2026-11-03. 3.1.0 est la
version du format OpenAPI et 1.0.0 est la version de la compétence ; ni l'une ni l'autre n'est la version de l'API.
L'API est décrite comme bêta. Ne présumez pas de la compatibilité avec d'autres versions.
Choisir une opération
| Besoin | Méthode et chemin |
|---|---|
| Lister les portefeuilles | GET /getPortfele.php |
| Avoirs, performance, historique, dividendes, comptes, passifs | GET /getPortfel.php |
| Transactions ou flux de trésorerie en JSON | POST /importOperacji.php |
| Fichier d'export courtier | POST /importOperacjiPlik.php |
| Export PPK avec répartition des contributions | POST /importOperacjiPPKPlik.php |
Avant de construire une requête, lisez le point d'accès concerné et ses schémas dans references/openapi.yaml. Des conseils pratiques et des exemples se trouvent dans references/workflows.md. N'inventez pas de points d'accès, de noms de sources d'import ou de paramètres non documentés.
Authentification et exécution
Obtenez la clé depuis Menu > Konto > Ustawienia konta > Klucz API.
Sa régénération invalide la clé précédente. Utilisez un secret provenant de l'environnement
(par ex. MYFUND_API_KEY) ; ne le stockez pas dans la compétence ni dans les exemples.
Ne journalisez pas les URL complètes contenant la clé, les en-têtes de diagnostic ou les données privées.
Ne lisez pas et n'affichez pas l'intégralité d'un fichier .env pour trouver un seul secret.
Les lectures nécessitent apiKey dans la requête. Pour les imports, utilisez le corps JSON ou les champs multipart.
Encodez les paramètres dans l'URL, en préservant les caractères polonais et le nom exact du portefeuille, pas son ID.
Pour les requêtes multipart, laissez le client générer l'en-tête Content-Type avec sa limite.
Vérifiez à la fois HTTP et status.code : "0" signifie succès, "1" une erreur,
et "7" un portefeuille manquant. Un code HTTP 200 seul ne confirme pas le succès.
Si la réponse ne contient pas le statut ou les données attendus, signalez un résultat incomplet.
Les lectures sont mises en cache pendant 5 minutes ; les imports ne le sont pas. Ne promettez pas de mises à jour
immédiates des données récupérées après un import.
Lecture et interprétation
Récupérez d'abord la liste des portefeuilles si le nom est inconnu. Lorsque vous limitez le
scope, incluez toujours status ; sélectionnez uniquement les champs nécessaires.
scope s'applique uniquement au niveau supérieur et est sensible à la casse.
Les champs inconnus sont omis ; un champ manquant ne signifie pas zéro.
Préservez la devise, les dates et les unités. Les valeurs numériques sont souvent des chaînes,
parfois avec + ; traitez les valeurs vides, --- et comme des données manquantes.
Ne convertissez pas aveuglément l'objet entier en nombres. Utilisez l'arithmétique décimale pour l'argent.
Les tickers et l'historique sont des cartes, pas des tableaux ; les séries temporelles sont des cartes indexées par date.
Ne confondez pas les valeurs monétaires dans struktura avec les parts dans strukturaWalory.
Les imports modifient le portefeuille
Préparer les données ne suffit pas à autoriser la soumission d'un import. Exécutez un import lorsque l'utilisateur le demande ; ne demandez pas à nouveau une autorisation déjà donnée. Avant de soumettre, établissez le portefeuille, les données, les comptes, la source du fichier et la politique de dédoublonnage. Si une information affectant l'écriture est manquante, préparez un aperçu et demandez-la. Ne remplissez pas des prix, quantités, dates ou taxes inconnus.
Conservez duplikaty=1 et sprawdzCene="true" par défaut.
duplikaty=2 peut dupliquer les opérations ; utilisez-le uniquement sur instruction explicite.
Ne présumez pas que les imports sont atomiques ou idempotents. Après un délai d'attente ou une perte de connexion,
ne réessayez pas automatiquement une requête POST : vérifiez l'historique et le statut de l'import, en tenant compte du cache.
Il n'existe pas de mode dry-run documenté ; un aperçu local n'est pas une validation serveur.
Une fois terminé, signalez le statut, le nombre d'opérations, les omissions et la date la plus ancienne
lorsqu'elle est présente dans la réponse. Distinguez la préparation de la requête d'un import exécuté.