myFund.pl API v1
互換性: myFund.pl API v1、ベースURL https://myfund.pl/API/v1。
ソース: 2026-11-03 日付のバンドルドキュメントスナップショット。3.1.0 は
OpenAPI フォーマットバージョン、1.0.0 はスキルバージョンであり、いずれも API バージョンではありません。
API はベータ版と記載されています。他のバージョンとの互換性を仮定しないでください。
操作の選択
| 必要な操作 | メソッドとパス |
|---|---|
| ポートフォリオ一覧 | GET /getPortfele.php |
| 保有銘柄、パフォーマンス、履歴、配当、口座、負債 | GET /getPortfel.php |
| JSON 形式の取引またはキャッシュフロー | POST /importOperacji.php |
| ブローカーエクスポートファイル | POST /importOperacjiPlik.php |
| 拠出内訳付き PPK エクスポート | POST /importOperacjiPPKPlik.php |
リクエストを構築する前に、references/openapi.yaml で該当するエンドポイントとそのスキーマを参照してください。 実用的なガイダンスと例は references/workflows.md にあります。 エンドポイント、インポートソース名、または文書化されていないパラメータを発明しないでください。
認証と実行
キーは メニュー > アカウント > アカウント設定 > APIキー から取得します。
再生成すると以前のキーは無効になります。環境変数（例: MYFUND_API_KEY）からのシークレットを使用し、スキルや例の中に保存しないでください。
キー、診断ヘッダー、またはプライベートデータを含む完全な URL をログに記録しないでください。
単一のシークレットを見つけるために .env ファイル全体を読み取って表示しないでください。
読み取り操作にはクエリに apiKey が必要です。インポートの場合は、JSON ボディまたはマルチパートフィールドを使用します。
パラメータは URL エンコードし、ポーランド文字と正確なポートフォリオ名（ID ではない）を保持します。
マルチパートリクエストの場合は、クライアントにバウンダリ付きの Content-Type を生成させます。
HTTP と status.code の両方を確認します: "0" は成功、"1" はエラー、
"7" はポートフォリオが存在しません。HTTP 200 だけでは成功を確認できません。
レスポンスに期待されるステータスまたはデータがない場合は、不完全な結果を報告します。
読み取り結果は 5 分間キャッシュされます。インポートはキャッシュされません。
インポート後に取得データが即座に更新されることを約束しないでください。
読み取りと解釈
ポートフォリオ名が不明な場合は、まずポートフォリオリストを取得します。scope を制限するときは、
常に status を含め、必要なフィールドのみを選択します。
scope はトップレベルにのみ適用され、大文字と小文字を区別します。
不明なフィールドは省略されます。フィールドが欠落していてもゼロを意味しません。
通貨、日付、単位を保持します。数値は多くの場合文字列で、
時々 + が含まれます。空の値、---、 は欠損データとして扱います。
オブジェクト全体を盲目的に数値に変換しないでください。金額には10進数演算を使用します。
tickers と history は配列ではなくマップです。時系列は日付をキーとしたマップです。
struktura 内の金額と strukturaWalory 内の株式数を混同しないでください。
インポートはポートフォリオを変更します
データを準備するだけでは、インポートの送信を許可しません。ユーザーが要求した場合にのみインポートを実行します。 すでに付与された認可について再度尋ねないでください。 送信する前に、ポートフォリオ、データ、口座、ファイルソース、重複ポリシーを確定します。 書き込みに影響する情報が不足している場合は、プレビューを準備して入力を求めます。 不明な価格、数量、日付、または税金を入力しないでください。
デフォルトでは duplikaty=1 と sprawdzCene="true" を維持します。
duplikaty=2 は操作を重複させる可能性があります。明示的な指示がある場合のみ使用します。
インポートがアトミックまたは冪等であると想定しないでください。タイムアウトまたは接続喪失後は、
自動的に POST を再試行しないでください。履歴とインポートステータスを確認し、キャッシュを考慮してください。
文書化されたドライランモードはありません。ローカルプレビューはサーバー検証ではありません。
完了後、レスポンスに存在する場合、ステータス、操作数、欠落、および最も古い日付を報告します。
リクエストの準備と実行されたインポートを区別します。