導入ドキュメント
インターフェースの紹介
このインターフェイスは、以前のファンド マネージャーに履歴データのクエリ サービスを提供します。開発者は、名前、一意の ID、アバター (Base64 形式)、任命日、在職期間中の累積収益率などの標準ファンド コードを渡すことにより、ファンドの過去のすべてのファンド マネージャーの詳細情報を取得できます。
該当するシナリオ
- 財務データ分析: ファンドのポートフォリオを構築し、ファンドマネージャーの変更がパフォーマンスに与える影響を分析します。
- 投資調査補助ツール: ファンド管理チームの歴史的な安定性と過去のパフォーマンスを投資家に示します。
- 財務管理 APP 開発: 情報の透明性を向上させるために、ファンドの詳細ページに「履歴マネージャー」モジュールを追加します。
リクエストと返品の手順
- リクエスト方法: POST
- コアパラメータ:
fundCode(文字列、必須)、クエリ対象のファンドコードです。 - 戻り構造:
code/msg: インターフェイスのステータス コードと説明。data: 数値インデックス (「0」、「1」など) によって配列された以前のマネージャー オブジェクトの配列が含まれます。- マネージャーの詳細フィールド:
name: マネージャー名の配列。gmtCreate: 予約日 (形式 YYYY-MM-DD)。gmtGrowth: 就職収益率(数値型、単位は%)。avatar: マネージャーのアバター Base64 文字列配列。id: マネージャーの一意の識別 ID の配列。
提案へのアクセス
- データ解析: 返された
dataオブジェクトは、数値キー名を使用して並べ替えられます。時間順序を維持するために配列処理に変換することをお勧めします。 - アバター処理: 「アバター」フィールドは、Base64 でエンコードされた画像を返します。フロントエンドは
<img>タグの src 属性に直接使用できます。キャッシュの最適化に注意してください。 - 例外処理:
codeが 200 であるかどうかを確認してください。ステータスが成功でない場合は、msgに従ってユーザーにプロンプトが表示されるか、ログに記録されるはずです。
実装サンプルコード
Shell、Python、Go、Java、PHP の呼び出し例をまとめ、既存プロジェクトに組み込みやすくしています。
リクエスト例
{
"fundCode": "基金代码"
}レスポンス例
{
"code": 200,
"msg": "成功",
"taskNo": "492823910191448773171202",
"data": {
"0": {
"name": [
"张璐"
],
"avatar": [
"data:image/jpg;base64,iVBORw0KGgoxxxxx"
],
"id": [
"145420292ef07aceb559cc8b7b7cd97a"
],
"gmtGrowth": -18.55,
"gmtCreate": "2023-05-04"
}
}
}リクエスト項目
以下の項目はサンプル 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 | object |
| properties | object | {...} |
| properties.code | object | {...} |
| properties.code.type | string | number |
| properties.code.example | number | 200 |
| properties.code.description | string | 返回码,详见返回码说明 |
| properties.msg | object | {...} |