導入ドキュメント
インターフェースの紹介
このインターフェースは、ファンドコードに基づいたアナウンスデータ検索サービスを提供します。開発者は、ターゲットファンドのコードを入力することで、ファンドが発表したさまざまな発表のリストを取得できます。これには、発表のリリース日、完全なタイトル、テキストの内容が含まれます。このインターフェイスはページング クエリをサポートしているため、オンデマンドで履歴データを簡単に取得できます。
該当するシナリオ
- 財務情報の集約: 特定のファンドの最新の開示情報を財務管理 APP または Web サイトに提供します。
- 投資調査データ分析: 世論監視やファンダメンタルズ分析のために、ファンドの四半期報告書、年次報告書、臨時発表を自動的に収集します。
- コンプライアンス監査支援: 内部コンプライアンス検査のニーズを満たすために、特定の期間内にファンド開示記録を迅速にレビューします。
リクエストと返品の手順
リクエスト方法: POST コアパラメータ:
fundCode(必須): ターゲットファンドの 6 桁のコード。pageNo(オプション): ページ番号、デフォルトは 1 です。pageSize(オプション): ページごとの項目数、デフォルトは 10、最大サポートは 50。
結果を返す: 成功すると、標準の JSON 構造が返されます。 data.list 配列には複数のアナウンス オブジェクトが含まれており、各オブジェクトには次のものが含まれます。
date: 発表のリリース時間。title: 発表の完全なタイトル。content: お知らせの本文。
同時に、ページング ロジックのフロントエンド実装を容易にするために、「total」内のレコードの総数が返されます。
提案へのアクセス
- キャッシュ戦略: ファンドの発表は低頻度の更新データです。繰り返しのリクエストを減らすために、取得した履歴アナウンスをローカルにキャッシュすることをお勧めします。
- ページング処理: 最初のロードでは最初のページのみを要求できます。ユーザーが「さらに読み込む」をトリガーすると、応答速度を最適化するために後続のページが非同期的にリクエストされます。
- 例外処理: 戻りコード
codeを確認してください。200 の場合はdataフィールドを解析し、それ以外の場合はユーザーにプロンプトを表示するか、msgに従ってログを記録します。
実装サンプルコード
Shell、Python、Go、Java、PHP の呼び出し例をまとめ、既存プロジェクトに組み込みやすくしています。
リクエスト例
{
"fundCode": "基金代码",
"pageNo": "页码,默认1",
"pageSize": "每页记录数,默认10,最大50"
}レスポンス例
{
"code": 200,
"msg": "成功",
"taskNo": "492823910191448773171202",
"data": {
"total": 207,
"limit": 10,
"page": 1,
"list": [
{
"date": "2024-07-18 00:00:00",
"title": "中航混改精选混合型证券投资基金2024年第2季度报告",
"content": "中航混改精选混合型证券投资基金\n 2024 年第 2 季度报告\n\nXXXXXXX"
}
]
}
}リクエスト項目
以下の項目はサンプル JSON から自動抽出した参考情報です。
| パス | 型 | サンプル値 |
|---|---|---|
| type | string | object |
| properties | object | {...} |
| properties.fundCode | object | {...} |
| properties.fundCode.type | string | string |
| properties.fundCode.description | string | 基金代码 |
| properties.pageNo | object | {...} |
| properties.pageNo.type | string | string |
レスポンス項目
以下の項目はサンプル 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 | {...} |