印度股票分红与拆股 API:无记录不等于请求失败

发布于 2026年10月26日

splits.msg 中的一句话,很容易让采集任务误入重试循环。已保存的 Infosys 样本说,近几年没有宣布拆股;同一次 HTTP 200 响应里,董事会会议、分红和送股却有可用表格。没有拆股公告,并不意味着整次查询失败,更不该把已经拿到的分红记录一起丢弃。

印度股票交易所 API 的 corporate-actions 是只读查询,必填输入只有 stock_name,已成功观察的值为 infosys。下面要实现的是公司行动结果分类器,而不是判断某只股票是否值得投资:五类结果分别保存状态,同时保留原始表格,供研究页面和后续核对使用。

先读 splits.msg:没有拆股记录不代表调用失败

样本的 splits 只有 title 和 msg,没有表头和数据行。消息原文为 “Infosys has not announced any stock split for the last few years.”,rights 也以同样方式报告近几年无配股公告。这里的“近几年”不是可精确换算的起始日期,也不能扩大解释为公司历史上从未发生过这些行动。

执行层应先判断 HTTP 状态,再检查网关 code、message、data 业务结果,业务成功码 200 与 HTTP 200 是两层判断。网关成功后才把提取出的公司行动对象交给分类器;不要给已经提取的原始对象再套一个自行编造的成功包装。

需要主动调用时,公开路由为:

https://api.opendata-api.com/api/project/indian-stock-exchange-api/corporate-actions?key=YOUR_API_KEY&stock_name=infosys

只在获授权环境中替换平台密钥。URL 可能进入日志、终端历史和监控系统,分享前应脱敏。打开页面、切换导航或复制示例都不应发起数据请求。

分别保留董事会会议、分红、拆股、送股和配股五类结果

用一个 has_events 布尔值会丢掉实际差异。响应包含 board_meetings、dividends、splits、bonus、rights,同一家公司可以有分红和送股记录,但某类行动明确无公告。

每类结果保留自己的标题、消息和原始内容。某部分缺失不能直接记成“无记录”:它可能是未返回、结构改变,或者当前解析器还不认识,应标为未知。没有记录和不知道有没有记录,不能在数据库里存成同一个状态。

这里不提供交易所、日期范围、行动类型或分页参数。本地只展示某一类可以,但不能把返回子集宣称为完整历史,也不能认为它天然就是未来事件日历。

逐类检查 headers 与 data,不假设表头和行结构相同

虽然常泛称“headers”,本样本实际字段是单数 header,值为列名字符串数组;data 则是字符串二维数组。会议的列为 Date、Agenda,分红为 Record Date、Ex-Date、Dividend Percentage、Details,送股为 Record Date、Ex-Date、Ratio。

必须用本类表头解释本类行,不能把分红第三列套到会议议程。日期、百分比、比例先保持原始字符串,确认格式和含义后再转换。分红百分比不是现金到账金额,送股比例也不自动形成复权价格序列;更新延迟、覆盖范围和再分发权限需要另外确认。

拆股和配股的有记录表格没有在本次样本中出现,因此不能虚构它们的列。即使字符串类型都对,列数与行宽不一致也应进入格式复核,不要用未经检查的 zip 静默截掉多余单元格。

区分有记录、明确无记录、结果未定与真正失败

分类器使用四种分项状态:records 表示非空且结构可用的表格,不代表业务准确性;reported_absence 表示已审核消息明确报告无事件且没有行;unknown 包括缺部分、无明确消息的空表和陌生消息;invalid 表示类型异常、半张表、行宽错误,或“无记录”消息与数据行冲突。

无公告消息只精确识别已观察的两句话,不用包含“not”之类宽松规则。否则一条服务错误也可能被吞成正常空结果。换公司后出现不同文案,先保留原文并标为未知,审核后再扩展识别规则,不为确认措辞额外重复请求。

无拆股或配股记录不进重试队列,真正失败再分类处理

正常无公告不能触发重试;未知和格式异常也不适合无限重跑,应先检查契约并保留诊断。其他部分有可用表格时仍可展示,不必整份清空。

真正的请求失败由独立策略处理:授权或输入错误先停止,限流按指示等待,符合条件的临时网络或服务故障才有限重试。数据看起来旧、条数少、事件不符合预期,都不是执行失败证据。采集时间与事件日期分别保存,回归解析器时复用已有 JSON,不为业务疑问再次消耗调用。

用完整分类脚本同时输出分项状态与原始表格

把网关成功后提取的公司行动对象保存为本地 actions.json,运行 python classify_actions.py actions.json。下面的完整脚本只读本地文件,不发网络请求;输出保留五类原始内容和表格,普通无记录不会要求重试。修改分类规则后,可直接用同一份已保存响应复核结果。

import json
import sys

SECTIONS = ("board_meetings", "dividends", "splits", "bonus", "rights")
ABSENCE = {
    "splits": "Infosys has not announced any stock split for the last few years.",
    "rights": "Infosys has not announced any rights for the last few years.",
}


def classify_section(name, section):
    result = {"state": "unknown", "retry_request": False, "raw": section}
    if section is None:
        result["reason"] = "section missing or null"
        return result
    if not isinstance(section, dict):
        return {**result, "state": "invalid", "reason": "section is not an object"}
    title, message = section.get("title"), section.get("msg")
    if not isinstance(title, str) or not isinstance(message, str):
        return {**result, "state": "invalid", "reason": "title/msg type mismatch"}
    result.update(title=title, message=message)
    has_header, has_data = "header" in section, "data" in section
    absence = name in ABSENCE and message == ABSENCE[name]
    if has_header != has_data:
        return {**result, "state": "invalid", "reason": "partial table"}
    if not has_header:
        return {**result, "state": "reported_absence" if absence else "unknown"}
    header, rows = section["header"], section["data"]
    result.update(header=header, data=rows)
    valid = (
        isinstance(header, list) and all(isinstance(x, str) for x in header)
        and isinstance(rows, list)
        and all(isinstance(row, list) and all(isinstance(x, str) for x in row)
                for row in rows)
    )
    if not valid:
        return {**result, "state": "invalid", "reason": "table type mismatch"}
    if any(len(row) != len(header) for row in rows) or (rows and not header):
        return {**result, "state": "invalid", "reason": "row/header width mismatch"}
    if absence and rows:
        return {**result, "state": "invalid", "reason": "absence conflicts with rows"}
    state = "records" if rows else "reported_absence" if absence else "unknown"
    return {**result, "state": state}


def classify_actions(body):
    if not isinstance(body, dict):
        raise ValueError("Expected an extracted corporate-action object")
    if "error" in body or not any(name in body for name in SECTIONS):
        raise ValueError("Not a recognized corporate-action result")
    return {name: classify_section(name, body.get(name)) for name in SECTIONS}


if __name__ == "__main__":
    with open(sys.argv[1], encoding="utf-8") as handle:
        body = json.load(handle)
    print(json.dumps(classify_actions(body), ensure_ascii=False, indent=2))