数字可直接用于报道
韩国实时债务时钟是一个公开数据可视化项目,按秒插值韩国银行ECOS、统计厅KOSIS、企划财政部"公开财政数据"的最新官方快照。所有数值与正文采用 CC BY 4.0 许可,注明出处后可自由再利用。
引用前需要确认的三件事
- 基准日:页面上的数字是对最近一次官方发布值(asOf)按年增长率推算的估算值。报道中请区分"某年某月的官方数字"和"本站的估算值"。
- 口径:同样叫"国家债务",各国作为主数值的口径并不相同——韩国用D1,日本用中央政府债务,西班牙用EDP债务,美国用联邦政府总债务。做跨国比较时,先统一口径。
- 可复现:引用不断变化的数字时,请附上固定时点的快照API地址,读者和编辑日后可以取回完全相同的数值。
引用格式
以下为论文和报告用的示例。英文格式(APA第7版、芝加哥第17版)使用英文版标题和网址,其下附中文文献著录格式。访问日期请换成实际查阅的日期;引用专题文章时,以页面显示的更新日期作为发布日期。
APA——债务时钟页面
WorldRealDebt. (n.d.). South Korea Debt Clock. Retrieved October 20, 2026, from https://worldrealdebt.com/
APA——专题解读文章
WorldRealDebt. (2026, July 31). Confuse D1, D2 and D3, and you will misread Korea's national debt. https://worldrealdebt.com/en/stories/korea-d1-d2-d3-debt/
APA——固定时点数据(API快照)
WorldRealDebt. (2026). South Korea Debt Clock snapshot at 2026-10-20T00:00:00Z [Data set]. https://worldrealdebt.com/api/korea/snapshot.json?t=2026-10-20T00:00:00Z
芝加哥——专题解读文章
WorldRealDebt. “Confuse D1, D2 and D3, and you will misread Korea's national debt.” Last modified July 31, 2026. Accessed October 20, 2026. https://worldrealdebt.com/en/stories/korea-d1-d2-d3-debt/.
中文著录格式
WorldRealDebt.《不区分 D1、D2、D3,就会读错韩国的国家债务》[EB/OL]. (2026-07-31)[2026-10-20]. https://worldrealdebt.com/zh/stories/korea-d1-d2-d3-debt/.
新闻与广播用的简短署名及原始来源列表
South Korea Debt Clock (worldrealdebt.com/korea), accessed YYYY-MM-DD. Underlying sources: Bank of Korea ECOS, Statistics Korea KOSIS, Ministry of Economy and Finance "Open Fiscal Data", KITA.
嵌入小组件
要在文章或博客中放入实时计数器,请粘贴下面的iframe。小组件读取本站的公开数据文件,在浏览器中更新数字,并在下方显示来源链接。
<iframe src="https://worldrealdebt.com/widget?country=korea&metric=nationalDebt&lang=zh&theme=auto" width="400" height="200" style="border:0;max-width:100%;" loading="lazy" title="WorldRealDebt widget"></iframe>
网址参数:country(korea、china、japan、usa、spain)、metric、lang(ko、en、ja、zh、es、fr)、currency(KRW、USD、JPY、EUR、CNY)、theme(dark、light、auto)、size(sm、md、lg)、accent(#RRGGBB)、showSource(设为0时隐藏来源行,此时须在正文中注明来源)。不支持的取值会回落为默认值。
支持的指标(metric): nationalDebt, householdDebt, debtPerCitizen, gdp, debtToGDP, fiscalBalance, population, foreignReserves
在小组件工作室(/widget/studio/)可以边预览边复制iframe、Markdown或WordPress代码。用于使用统计时,小组件只记录嵌入页面所在网站的源(origin),不记录完整的页面网址。
公开JSON API
- /api/korea/live.json — 当前时刻的插值估算值,缓存30秒。
- /api/korea/snapshot.json?t=<ISO> — 指定时点的确定性快照。同一个t无论何时调用都返回相同数值,适合用来复现引用。
响应字段说明和示例见 API文档.
许可
本站自行制作的文字、图表、解读、术语说明以及API响应均以知识共享署名4.0(CC BY 4.0)许可提供。包括商业用途在内,均可复制、传播和改编,只需注明"WorldRealDebt"和原页面网址,如有改动须加以说明。
韩国银行、各国统计机构和财政部门等原始来源机构的数据本身不属于CC BY 4.0的范围,须遵守各机构的使用条件。直接引用原始数据时,请一并写明来源页面列出的机构名称和发布日期。
标志与社交卡片
联系渠道
- 采访及数据使用咨询: [email protected]
- 数字有误请按更正页面的流程通过GitHub Issues提交;确认的更正会连同日期记录在同一页面的变更记录中: 更正请求与变更记录 · github.com/eightynine01/WorldRealDebt/issues
- 各项指标的原始来源、基准日和发布周期: 数据来源