新增公司资料/指数/重大事项等 13 个接口, 文档全面对齐

- 新增 fin_mda/fin_equity/fin_company/fin_belong_index/fin_major_events 5 个模块
- 覆盖: 管理层讨论、股本结构、公司介绍、所属行业、指数分类/统计/成分、并购/股权激励/诉讼/关联交易/违规/担保
- _emchoice.fetch_report 支持"数据为空"按空结果处理
- api.py 增加 _simple_endpoint 统一生成纯 stocks 参数接口, 路由达 29 个 /fin 端点
- 冒烟测试扩展至 56 用例, 全部通过
- api_manual/blueprint/SKILLS/待优化 文档与代码路径 100% 对齐
This commit is contained in:
2026-08-15 11:34:11 +08:00
parent 797369bbed
commit 2ce68b7b5d
13 changed files with 1147 additions and 11 deletions
+246
View File
@@ -335,3 +335,249 @@ Sec-Fetch-Dest: empty
Referer: https://emchoicew.eastmoney.com/
Accept-Encoding: gzip, deflate, br
## 管理层讨论与分析
---
GET /api/data/v1/get?source=CHOICE&reportName=RPT_BUSINESSANALYSIS&columns=ORG_CODE%2CSECUCODE%2CSECURITY_CODE%2CSECURITY_INNER_CODE%2CSECURITY_NAME_ABBR%2CREPORT_DATE%2CREPORT_NAME%2CNOTICE_DATE%2CSOURCE%2CRELINFOCODE%2CTITLE%2CPAGE&quoteColumns=&filter=(SECUCODE%3D%22603233.SH%22)(REPORT_NAME+in+(%22%E5%B9%B4%E6%8A%A5%22%2C%22%E4%B8%AD%E6%8A%A5%22))(REPORT_DATE%3C%3D%272026-08-15%27)(REPORT_DATE%3E%3D%272021-08-15%27)&pageNumber=1&pageSize=50&sortTypes=-1&sortColumns=REPORT_DATE&source=CHOICE&client=SW HTTP/1.1
Host: datacenter-choice.eastmoney.com
Connection: keep-alive
sec-ch-ua: "Chromium";v="104"
Accept: application/json
sec-ch-ua-mobile: ?0
User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.102 Safari/537.36
sec-ch-ua-platform: "Windows"
Origin: https://emchoicew.eastmoney.com
Accept-Language: zh-CN,zh;q=0.9
Sec-Fetch-Site: same-site
Sec-Fetch-Mode: cors
Sec-Fetch-Dest: empty
Referer: https://emchoicew.eastmoney.com/
Accept-Encoding: gzip, deflate, br
## 股本结构
---
GET /api/data/v1/get?source=CHOICE&reportName=RPT_F10_EH_EQUITY&columns=CHOICE_F9_EH_EQUITY&quoteColumns=&pageNumber=1&pageSize=&sortColumns=END_DATE&client=SW&filter=(SECUCODE=%22603233.SH%22)(LISTING_DATE%3E=%271900-01-01%27)(LISTING_DATE%3C=%272026-12-31%27)&sortTypes=-1 HTTP/1.1
Host: datacenter-choice.eastmoney.com
Connection: keep-alive
sec-ch-ua: "Chromium";v="104"
Accept: application/json
version:
sec-ch-ua-mobile: ?0
User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.102 Safari/537.36
token:
sec-ch-ua-platform: "Windows"
Origin: https://emchoicew.eastmoney.com
Accept-Language: zh-CN,zh;q=0.9
Sec-Fetch-Site: same-site
Sec-Fetch-Mode: cors
Sec-Fetch-Dest: empty
Referer: https://emchoicew.eastmoney.com/
Accept-Encoding: gzip, deflate, br
## 按地区分类
---
GET /stock/f9/ZYGC_AFLZS?SecurityCode=603233.SH&StartDate=2023-08-15&EndDate=2026-08-15&ReportPeriodType=%221%22%2C%225%22%2C%223%22%2C%226%22&Magnitude=4&ClassifyType=%E5%9C%B0%E5%8C%BA&ReportShowForm=0&ExchangeRate=1&Digits=2&Sort=-1&IsShowEmptyRow=true HTTP/2
host: emchoicews2.eastmoney.com
sec-ch-ua: "Chromium";v="104"
accept: application/json
sec-ch-ua-mobile: ?0
user-agent: Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.102 Safari/537.36
sec-ch-ua-platform: "Windows"
origin: https://emchoicew.eastmoney.com
accept-language: zh-CN,zh;q=0.9
sec-fetch-site: same-site
sec-fetch-mode: cors
sec-fetch-dest: empty
referer: https://emchoicew.eastmoney.com/
accept-encoding: gzip, deflate, br
## 公司介绍 + 所属行业与指数
---
GET /api/data/v1/get?source=CHOICE&reportName=RPT_HSF9_BASIC_ORGINFO&columns=HSF9_ORGINFO&quoteColumns=&filter=(SECUCODE%3D%22603233.SH%22)&pageNumber=1&pageSize=200&client=SW HTTP/1.1
Host: datacenter-choice.eastmoney.com
Connection: keep-alive
sec-ch-ua: "Chromium";v="104"
Accept: application/json
sec-ch-ua-mobile: ?0
User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.102 Safari/537.36
sec-ch-ua-platform: "Windows"
Origin: https://emchoicew.eastmoney.com
Accept-Language: zh-CN,zh;q=0.9
Sec-Fetch-Site: same-site
Sec-Fetch-Mode: cors
Sec-Fetch-Dest: empty
Referer: https://emchoicew.eastmoney.com/
Accept-Encoding: gzip, deflate, br
---
GET /api/data/v1/get?reportName=RPT_STOCKF9_INDUSTRY&columns=SECUCODE%2CSECURITY_CODE%2CSECURITY_NAME_ABBR%2CINDUSTRY_TYPE_CODE%2CINDUSTRY_TYPE%2CINDUSTRY_NAME%2CINDUSTRY_CODE%2CSECURITY_INNER_CODE%2CINDUSTRY_NAME_MIN%2CINDUSTRY_CODE_MIN%2CENTRY_DATE%2COUT_DATE%2CSECURITY_TYPE_CODE%2CSTATE%2CSTATE_CODE%2CRN&quoteColumns=&filter=(SECUCODE%3D%22603233.SH%22)(STATE_CODE%3D%221%22)&pageNumber=&pageSize=&sortTypes=1&sortColumns=RN&source=CHOICE&client=SW HTTP/1.1
Host: datacenter-choice.eastmoney.com
Connection: keep-alive
sec-ch-ua: "Chromium";v="104"
Accept: application/json
sec-ch-ua-mobile: ?0
User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.102 Safari/537.36
sec-ch-ua-platform: "Windows"
Origin: https://emchoicew.eastmoney.com
Accept-Language: zh-CN,zh;q=0.9
Sec-Fetch-Site: same-site
Sec-Fetch-Mode: cors
Sec-Fetch-Dest: empty
Referer: https://emchoicew.eastmoney.com/
Accept-Encoding: gzip, deflate, br
---
GET /api/data/v1/get?reportName=RPT_HSF9_BELONGINDEX_CLASSIF&columns=INDEX_CLASSIF_CODE%2CINDEX_CLASSIF&quoteColumns=&filter=(SECUCODE%3D%22603233.SH%22)(STR_TYPE%3D%221%22)&distinct=INDEX_CLASSIF_CODE%2CINDEX_CLASSIF&pageNumber=&pageSize=&source=CHOICE&client=SW HTTP/1.1
Host: datacenter-choice.eastmoney.com
Connection: keep-alive
sec-ch-ua: "Chromium";v="104"
Accept: application/json
sec-ch-ua-mobile: ?0
User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.102 Safari/537.36
sec-ch-ua-platform: "Windows"
Origin: https://emchoicew.eastmoney.com
Accept-Language: zh-CN,zh;q=0.9
Sec-Fetch-Site: same-site
Sec-Fetch-Mode: cors
Sec-Fetch-Dest: empty
Referer: https://emchoicew.eastmoney.com/
Accept-Encoding: gzip, deflate, br
---
GET /api/data/v1/get?reportName=RPT_CUSTOM_HSF9_BELONG_INDEX&filter=(SECUCODE%3D%22603233.SH%22)&source=CHOICE&client=SW HTTP/1.1
Host: datacenter-choice.eastmoney.com
Connection: keep-alive
sec-ch-ua: "Chromium";v="104"
Accept: application/json
sec-ch-ua-mobile: ?0
User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.102 Safari/537.36
sec-ch-ua-platform: "Windows"
Origin: https://emchoicew.eastmoney.com
Accept-Language: zh-CN,zh;q=0.9
Sec-Fetch-Site: same-site
Sec-Fetch-Mode: cors
Sec-Fetch-Dest: empty
Referer: https://emchoicew.eastmoney.com/
Accept-Encoding: gzip, deflate, br
---
GET /api/data/v1/get?reportName=RPT_HSF9_BELONG_INDEX&columns=INDEX_CODE%2CINDEX_INNER_CODE%2CTRADE_DATE%2CSECUCODE%2CSECURITY_CODE%2CSECURITY_NAME_ABBR%2CINCLUDE_DATE%2CMAKER_NAME%2CINDEX_NAME_ABBR%2CSECURITY_INNER_CODE%2CINDEX_CLASSIF_CODE%2CINDEX_CLASSIF%2CWEIGHT%2CNUM%2CTOTAL_SCALE%2CWEIGHT_DATE%2CCURRENCY&filter=(SECUCODE%3D%22603233.SH%22)((INDEX_CLASSIF_CODE+like+%22%25001001%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25001002%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25001003%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25001004%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25001005%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25001007%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25001009%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25001010%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25001011%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25001017%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25001020%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25001022%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25001025%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25001030%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25001006%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25001024%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25013003%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25014%25%22))&sortColumns=NUM%2CINDEX_CODE&sortTypes=-1%2C1&pageNumber=1&pageSize=50&source=CHOICE&client=SW HTTP/1.1
Host: datacenter-choice.eastmoney.com
Connection: keep-alive
sec-ch-ua: "Chromium";v="104"
Accept: application/json
sec-ch-ua-mobile: ?0
User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.102 Safari/537.36
sec-ch-ua-platform: "Windows"
Origin: https://emchoicew.eastmoney.com
Accept-Language: zh-CN,zh;q=0.9
Sec-Fetch-Site: same-site
Sec-Fetch-Mode: cors
Sec-Fetch-Dest: empty
Referer: https://emchoicew.eastmoney.com/
Accept-Encoding: gzip, deflate, br
## 重大事项(重组/激励/回购/担保/违规/诉讼)
---并购事件
GET /api/data/v1/get?reportName=RPT_HS_ACQUISITIONS_EVENT&columns=SECUCODE%2CSECURITY_CODE%2CFIRST_NOTICE_DATE%2CNOTICE_DATE%2CPLAN_PROCESS%2CNAME_OBJ%2CNAME_BUY%2CMXID%2CNAME_SELL%2CDEAL_AMT%2CTRANSFER_RATIO%2CTRADTE_CURRENCY&quoteColumns=&filter=(SECUCODE%3D%22603233.SH%22)(FIRST_NOTICE_DATE%3E%3D%272023-08-15%27)(FIRST_NOTICE_DATE%3C%3D%272026-08-15%27)&sortTypes=-1%2C1&sortColumns=FIRST_NOTICE_DATE%2CMXID&requestParams=1&pageNumber=1&pageSize=50&client=SW HTTP/1.1
Host: datacenter-choice.eastmoney.com
Connection: keep-alive
sec-ch-ua: "Chromium";v="104"
Accept: application/json
sec-ch-ua-mobile: ?0
User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.102 Safari/537.36
sec-ch-ua-platform: "Windows"
Origin: https://emchoicew.eastmoney.com
Accept-Language: zh-CN,zh;q=0.9
Sec-Fetch-Site: same-site
Sec-Fetch-Mode: cors
Sec-Fetch-Dest: empty
Referer: https://emchoicew.eastmoney.com/
Accept-Encoding: gzip, deflate, br
---股权激励
GET /api/data/v1/get?reportName=RPT_DMSK_SH_EQUITYINCENTIVE&columns=SECUCODE%2CORG_CODE%2CPLAN_PROCESS%2CEI_TARGET%2CEI_WAY%2CTOTAL_INCENTIVE_SHARES%2CTOTAL_INCENTIVE_TSR%2CINITIAL_EXERCISE_PRICE%2CVALID_EXPIRE%2CPLAN_NOTICE_DATE%2CGMDECISION_NOTICE_DATE%2CFIRST_NOTICE_DATE%2CPLAN_EXPLAIN%2CPRICE_EXPLAIN%2CINCENTIVE_SELL_EXPLAIN%2CINCENTIVE_GRANT_CONDITION%2CEXERCISE_SPECIAL_CONDITION%2CNOTICE_DATE%2CSTR_YEAR%2CSECURITY_NAME_ABBR%2CSECURITY_CODE%2CINDUSTRYCSRC%2CEM_INDUSTRY%2CPLAN_NUM&filter=(SECUCODE%3D%22603233.SH%22)(PLAN_NOTICE_DATE%3E%3D%272023-08-15%27)(PLAN_NOTICE_DATE%3C%3D%272026-08-15%27)&sortTypes=-1&sortColumns=PLAN_NOTICE_DATE&source=CHOICE&client=SW HTTP/1.1
Host: datacenter-choice.eastmoney.com
Connection: keep-alive
sec-ch-ua: "Chromium";v="104"
Accept: application/json
sec-ch-ua-mobile: ?0
User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.102 Safari/537.36
sec-ch-ua-platform: "Windows"
Origin: https://emchoicew.eastmoney.com
Accept-Language: zh-CN,zh;q=0.9
Sec-Fetch-Site: same-site
Sec-Fetch-Mode: cors
Sec-Fetch-Dest: empty
Referer: https://emchoicew.eastmoney.com/
Accept-Encoding: gzip, deflate, br
---诉讼仲裁
GET /api/data/v1/get?source=CHOICE&reportName=RPT_LITIGATION_ARBITRATION_BSINFO&columns=ORG_CODE%2CSECUCODE%2CSECURITY_CODE%2CSECURITY_NAME_ABBR%2CNOTICE_DATE%2CCASE_NAME%2CCASE_PROFILE%2CPLAINTIFF%2CDEFENCE%2CLITIGATION_TYPE%2CFI_PROSECUTE_DATE%2CFI_ACCEPTANCE_COURT%2CCASE_AMOUNT%2CFI_JUDGMENT_DATE%2CFI_JUDGMENT_CONTENT%2CFI_IS_APPEAL%2CSI_APPELLEE%2CSI_ACCEPTANCE_COURT%2CSI_JUDGMENT_DATE%2CSI_JUDGMENT_CONTENT%2CEXECUTE_SITUATION%2CCURRENCY%2CNOTICE_YEAR&quoteColumns=&filter=(SECUCODE%3D%22603233.SH%22)(NOTICE_YEAR%3E%3D%221900%22)(NOTICE_YEAR%3C%3D%222026%22)&pageNumber=&pageSize=&sortTypes=-1&sortColumns=NOTICE_DATE&client=SW HTTP/1.1
Host: datacenter-choice.eastmoney.com
Connection: keep-alive
sec-ch-ua: "Chromium";v="104"
Accept: application/json
sec-ch-ua-mobile: ?0
User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.102 Safari/537.36
sec-ch-ua-platform: "Windows"
Origin: https://emchoicew.eastmoney.com
Accept-Language: zh-CN,zh;q=0.9
Sec-Fetch-Site: same-site
Sec-Fetch-Mode: cors
Sec-Fetch-Dest: empty
Referer: https://emchoicew.eastmoney.com/
Accept-Encoding: gzip, deflate, br
---关联交易
GET /api/data/v1/get?reportName=RPT_RELATED_TRANSACTION&columns=SECUCODE,SECURITY_CODE,SECURITY_NAME_ABBR,ORG_CODE,NOTICE_DATE,RELATED_PARTY,RELATED_RELATION,IS_CONTROL,TRADE_AMT,PAY_WAY,TRADE_PROFILE,PRICE_BASIS,TRADE_START_DATE,TRADE_END_DATE,CURRENCY,STR_YEAR&quoteColumns=&filter=(SECUCODE=%22603233.SH%22);(NOTICE_DATE%3E=%271900-01-01%27)(NOTICE_DATE%3C=%272026-12-31%27)&pageNumber=&pageSize=&sortTypes=-1&sortColumns=NOTICE_DATE&client=SW&source=CHOICE HTTP/1.1
Host: datacenter-choice.eastmoney.com
Connection: keep-alive
sec-ch-ua: "Chromium";v="104"
Accept: application/json
sec-ch-ua-mobile: ?0
User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.102 Safari/537.36
sec-ch-ua-platform: "Windows"
Origin: https://emchoicew.eastmoney.com
Accept-Language: zh-CN,zh;q=0.9
Sec-Fetch-Site: same-site
Sec-Fetch-Mode: cors
Sec-Fetch-Dest: empty
Referer: https://emchoicew.eastmoney.com/
Accept-Encoding: gzip, deflate, br
---违规
GET /api/data/v1/get?source=CHOICE&reportName=RPT_HSF9_OP_VIOLATION&columns=ORG_CODE%2CNOTICE_DATE%2CNOTICE_YEAR%2CCURRENCY%2CSECUCODE%2CSECURITY_CODE%2CSECURITY_NAME_ABBR%2CSOLVE_ORG%2CVIOLATE_TYPE%2CPUNISH_TYPE%2CPUNISH_AMT%2CVIOLATE_BEHAVIOUR%2CPUNISH_STEP%2CPUNISH_OBJECT&quoteColumns=&filter=(secucode%3D%22603233.SH%22)(NOTICE_DATE%3E%3D%271900-01-01%27)(NOTICE_DATE%3C%3D%272026-12-31%27)&pageNumber=1&pageSize=&sortTypes=-1&sortColumns=NOTICE_DATE&client=SW HTTP/1.1
Host: datacenter-choice.eastmoney.com
Connection: keep-alive
sec-ch-ua: "Chromium";v="104"
Accept: application/json
sec-ch-ua-mobile: ?0
User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.102 Safari/537.36
sec-ch-ua-platform: "Windows"
Origin: https://emchoicew.eastmoney.com
Accept-Language: zh-CN,zh;q=0.9
Sec-Fetch-Site: same-site
Sec-Fetch-Mode: cors
Sec-Fetch-Dest: empty
Referer: https://emchoicew.eastmoney.com/
Accept-Encoding: gzip, deflate, br
---担保
GET /api/data/v1/get?source=CHOICE&reportName=RPT_F9_GUARANTEE&columns=SECURITY_CODE%2CSECUCODE%2CSECURITY_NAME_ABBR%2CREPORT_DATE%2CGUAR_NAME%2CGUARANTEED_NAME%2CGUARANTEE_START_DATE%2CGUARANTEE_END_DATE%2CIS_PERFORM%2CTRADE_DATE%2CGUARANTEE_WAY%2CGUARANTEE_AMT%2CGUARANTEE_EXPIRE%2CIS_RELATED_TRADE%2CCURRENCY%2CREPORT_YEAR%2CHISTORYCHG%2CORG_CODE&quoteColumns=&filter=(SECUCODE%3D%22603233.SH%22)(REPORT_YEAR%3E%3D%221900%22)(REPORT_YEAR%3C%3D%222026%22)&sortTypes=-1&sortColumns=REPORT_DATE&client=SW HTTP/1.1
Host: datacenter-choice.eastmoney.com
Connection: keep-alive
sec-ch-ua: "Chromium";v="104"
Accept: application/json
sec-ch-ua-mobile: ?0
User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.102 Safari/537.36
sec-ch-ua-platform: "Windows"
Origin: https://emchoicew.eastmoney.com
Accept-Language: zh-CN,zh;q=0.9
Sec-Fetch-Site: same-site
Sec-Fetch-Mode: cors
Sec-Fetch-Dest: empty
Referer: https://emchoicew.eastmoney.com/
Accept-Encoding: gzip, deflate, br