myFund.pl API v1
Kompatibilität: myFund.pl API v1, Basis-URL https://myfund.pl/API/v1.
Quelle: gebündelter Dokumentations-Snapshot vom 03.11.2026. 3.1.0 ist die
OpenAPI-Formatversion und 1.0.0 die Skill-Version; beides ist nicht die API-Version.
Die API wird als Beta beschrieben. Gehen Sie nicht von Kompatibilität mit anderen Versionen aus.
Wählen Sie eine Operation
| Bedarf | Methode und Pfad |
|---|---|
| Portfolios auflisten | GET /getPortfele.php |
| Bestände, Performance, Verlauf, Dividenden, Konten, Verbindlichkeiten | GET /getPortfel.php |
| Transaktionen oder Zahlungsströme als JSON | POST /importOperacji.php |
| Broker-Exportdatei | POST /importOperacjiPlik.php |
| PPK-Export mit Beitragsaufschlüsselung | POST /importOperacjiPPKPlik.php |
Bevor Sie eine Anfrage erstellen, lesen Sie den entsprechenden Endpunkt und seine Schemas in references/openapi.yaml. Praktische Anleitungen und Beispiele finden Sie in references/workflows.md. Erfinden Sie keine Endpunkte, Importquellnamen oder undokumentierte Parameter.
Authentifizierung und Ausführung
Den Schlüssel erhalten Sie über Menü > Konto > Ustawienia konta > Klucz API.
Das Neuerstellen macht den vorherigen Schlüssel ungültig. Verwenden Sie ein Secret aus der Umgebung
(z. B. MYFUND_API_KEY); speichern Sie es nicht im Skill oder in Beispielen.
Protokollieren Sie keine vollständigen URLs mit dem Schlüssel, Diagnose-Header oder private Daten.
Lesen und zeigen Sie keine gesamte .env-Datei an, um ein einzelnes Secret zu finden.
Lesevorgänge erfordern apiKey im Query. Bei Importen verwenden Sie den JSON-Body oder Multipart-Felder.
URL-kodieren Sie Parameter unter Beibehaltung polnischer Zeichen und des genauen Portfolionamens (nicht seiner ID).
Lassen Sie bei Multipart-Anfragen den Client Content-Type mit seinem Boundary generieren.
Überprüfen Sie sowohl HTTP als auch status.code: "0" bedeutet Erfolg, "1" einen Fehler
und "7" ein fehlendes Portfolio. HTTP 200 allein bestätigt keinen Erfolg.
Fehlt in der Antwort der erwartete Status oder die Daten, melden Sie ein unvollständiges Ergebnis.
Lesevorgänge werden 5 Minuten lang zwischengespeichert; Importe nicht. Versprechen Sie keine sofortigen
Aktualisierungen abgerufener Daten nach einem Import.
Lesen und Interpretation
Rufen Sie zuerst die Portfolio-Liste ab, wenn der Name unbekannt ist. Wenn Sie scope
einschränken, schließen Sie immer status ein; wählen Sie nur die benötigten Felder.
scope gilt nur auf der obersten Ebene und ist case-sensitiv.
Unbekannte Felder werden weggelassen; ein fehlendes Feld bedeutet nicht Null.
Behalten Sie Währung, Daten und Einheiten bei. Numerische Werte sind oft Strings,
manchmal mit +; behandeln Sie leere Werte, --- und als fehlende Daten.
Konvertieren Sie nicht blind das gesamte Objekt in Zahlen. Verwenden Sie Dezimalarithmetik für Geldbeträge.
tickers und Verlauf sind Maps, keine Arrays; Zeitreihen sind Maps mit Datum als Schlüssel.
Verwechseln Sie keine Geldbeträge in struktura mit Anteilen in strukturaWalory.
Importe verändern das Portfolio
Das Aufbereiten der Daten allein autorisiert keinen Import. Führen Sie einen Import aus, wenn der Benutzer es anfordert; fragen Sie nicht erneut nach einer bereits erteilten Autorisierung. Stellen Sie vor der Übermittlung Portfolio, Daten, Konten, Dateiquelle und Duplikatsrichtlinie fest. Fehlen Informationen, die den Schreibvorgang beeinflussen, erstellen Sie eine Vorschau und fragen Sie danach. Füllen Sie keine unbekannten Preise, Mengen, Daten oder Steuern aus.
Behalten Sie duplikaty=1 und sprawdzCene="true"" standardmäßig bei.
duplikaty=2 kann Operationen duplizieren; verwenden Sie es nur auf ausdrückliche Anweisung.
Gehen Sie nicht von atomaren oder idempotenten Importen aus. Nach einem Timeout oder Verbindungsabbruch
wiederholen Sie POST nicht automatisch: Überprüfen Sie den Verlauf und den Importstatus unter Berücksichtigung des Caches.
Es gibt keinen dokumentierten Trockenmodus; eine lokale Vorschau ist keine Servervalidierung.
Melden Sie nach Abschluss den Status, die Anzahl der Vorgänge, Auslassungen und das früheste Datum,
falls in der Antwort vorhanden. Unterscheiden Sie zwischen Anfragenerstellung und ausgeführtem Import.