導入ドキュメント
インターフェースの紹介
このインターフェイスは、公的資金の過去の配当および分配情報のクエリ サービスを提供します。開発者は、標準ファンド コードを入力するだけで、ファンドの過去の配当日、配当タイプ (現金配当または配当再投資など)、および特定の配当分配率データを取得できます。
該当するシナリオ
- 財務情報アプリケーション: ファンドの詳細ページに過去の配当記録を表示し、ユーザーがファンド収入の安定性を評価するのに役立ちます。
- 定量分析システム: ファクターモデルやバックテスト戦略を構築するためにバッチで配当データを取得します。
- 個人会計ツール: 保有資金の配当支払い情報を自動的に同期し、資産レポートを改善します。
リクエストと返品の手順
- リクエスト方法: POST
- コアパラメータ:
fundCode(文字列、必須)、6 桁のファンドコードです。 - 戻り構造:
code: ステータス コード、200 は成功を意味します。data.list: 特定の配当レコードを含む配列オブジェクト。date: 配当権利の登録日または支払日。type: 配当タイプ (「配当」など)。rate: 配当分配率の値。fundCode: 対応するファンドコード。
提案へのアクセス
- キャッシュ戦略: ファンドの配当データは、低頻度で変化する履歴データです。 API 呼び出しの数を減らし、応答速度を向上させるために、クエリ結果をローカルに (24 時間など) キャッシュすることをお勧めします。
- 例外処理: 返された「コード」フィールドを確認してください。ファンド コードが存在しない場合、または配当記録がない場合、インターフェイスは空のリストまたは特定のエラー コードを返す可能性があり、フロントエンドのフォールト トレランス表示が必要です。
- データの解釈: 「率」フィールドの具体的な意味 (10 株あたりの配当額など) は、ビジネス シナリオに基づいて確認する必要があります。ユーザーエクスペリエンスを向上させるために、UI にユニットの説明を追加することをお勧めします。
実装サンプルコード
Shell、Python、Go、Java、PHP の呼び出し例をまとめ、既存プロジェクトに組み込みやすくしています。
リクエスト例
{
"fundCode": "基金代码"
}レスポンス例
{
"code": 200,
"msg": "成功",
"taskNo": "492823910191448773171202",
"data": {
"list": [
{
"date": "2016-06-27",
"fundCode": "000263",
"rate": 0.2772,
"type": "分红"
}
]
}
}リクエスト項目
以下の項目はサンプル 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 | {...} |