導入ドキュメント
インターフェースの紹介
このインターフェイスは、ファンド コードに基づいてファンド マネージャーのコア データ クエリ サービスを提供します。呼び出し元は、指定したファンドに対応するマネージャーの任命日 (gmtCreate) と在任期間中の累積増減 (gmtGrowth) を取得できるため、ファンドマネージャーの過去の運用実績を迅速に評価することができます。
該当するシナリオ
- 金融端末表示:ファンド詳細ページに運用期間中の業績変動データを補足。
- 投資調査データ分析: 複数のファンドのマネージャーの在職期間と収入実績を一括して抽出し、水平比較します。
- インテリジェントな投資顧問システム: 要素の 1 つとして、ファンド管理の安定性と過去の収益能力を判断するのに役立ちます。
リクエストと返品の手順
- リクエスト方法: POST
- コアパラメータ:
fundCode(文字列、必須)、標準の 6 桁のファンドコードです。 - 戻り結果: 次のキー フィールドを含む JSON 配列:
fundName: ファンドの完全な名前gmtCreate: マネージャーの任命日 (形式: YYYY-MM-DD)gmtGrowth: 在職期間中の増減率の値 (注: フロントエンドに表示する場合はパーセント記号 % を自分で追加する必要があります)fundCode: 返されたファンドコード
提案へのアクセス
- データ精度の処理: 返される
gmtGrowthは浮動小数点数です。小数点以下 2 桁を保持し、フロントエンドまたはビジネス層で表示をフォーマットすることをお勧めします。 - 例外処理: 無効なファンド コードが渡された場合は、返品ステータス コードを確認し、元のエラー メッセージが直接公開されることを避けるためのわかりやすい注意喚起を提供してください。
- キャッシング戦略: ファンドマネージャーの変更頻度は低いです。 API 呼び出しの数を減らし、応答速度を向上させるために、クエリ結果を適切に (24 時間など) キャッシュすることをお勧めします。
実装サンプルコード
Shell、Python、Go、Java、PHP の呼び出し例をまとめ、既存プロジェクトに組み込みやすくしています。
リクエスト例
{
"fundCode": "基金代码"
}レスポンス例
[
{
"fundCode": "004936",
"gmtGrowth": -39.8128,
"fundName": "中航混改精选混合A",
"gmtCreate": "2023-03-30"
}
]リクエスト項目
以下の項目はサンプル JSON から自動抽出した参考情報です。
| パス | 型 | サンプル値 |
|---|---|---|
| type | string | object |
| properties | object | {...} |
| properties.fundCode | object | {...} |
| properties.fundCode.type | string | string |
| properties.fundCode.description | string | 基金代码 |
| required | array | "fundCode" |
| required[] | string | fundCode |
レスポンス項目
以下の項目はサンプル JSON から自動抽出した参考情報です。
| パス | 型 | サンプル値 |
|---|---|---|
| type | string | array |
| items | object | {...} |
| items.type | string | object |
| items.properties | object | {...} |
| example | array | {"fundCode":"004936","gmtGrowth":-39.8128,"fundName":"中航混改精选混合A","gmtCreate":"2023-03-30"} |
| example[] | object | {...} |
| example[].fundCode | string | 004936 |