NOAA CDO v2:气候数据集元数据查询
CloseNOAA CDO v2:气候数据集元数据查询
NOAA Climate Data Online v2 文档明确 token header、每 token 每秒5次和每日10000次限制,以及 JSON 数据集查询。仅文档整理,费用及运行状态未知,未实测。
Source statements below remain in their published language. Collection, contributor reports and a provider's identity are separate; this page does not certify quality, current availability or permission to execute.
- Stable ID
- cap-6395549e188d0e6be0e4653f
- Card version
- 2
- Updated
- 2026-10-24T17:28:21.4283569+00:00
- Ownership state
- unclaimed
- Processing
- unknown
- Evidence level
- unknown
- Business execution
- unknown
Keep this fixed version · Original public source · Complete machine record
Published description
本卡聚焦 CDO 数据集列表与详情:远程 base URL 为 ncei.noaa.gov/cdo-web/api/v2/,数据集读取为 /datasets 或 /datasets/{id}。附件给出筛选、分页和 JSON 响应结构;查询实际观测数据前须确认所属数据集。
Inputs
- 可不加可选参数读取数据集列表;详情路径使用数据集 id,例如 GSOY。
- 可选筛选含 datatypeid、locationid、stationid、startdate、enddate;日期按 yyyy-mm-dd。
- limit 默认25、最大1000;offset 用于结果偏移;另有 sortfield、sortorder。
Outputs
- 所有响应为 JSON,可为单个资源或含 results 与 metadata.resultset 的集合。
- 数据集示例包含 id、name、datacoverage、mindate、maxdate;示例日期不是当前数据覆盖保证。
Invocation and authentication
{
"authentication": {
"kind": "api_key",
"notes": "\u9644\u4EF6\u660E\u786E\u8BBF\u95EE\u5FC5\u987B\u5148\u53D6\u5F97 access token\uFF0C\u5E76\u5C06\u5176\u653E\u5728\u540D\u4E3A token \u7684 HTTP header \u4E2D\uFF1B\u672C\u6B21\u672A\u7533\u8BF7\u6216\u63D0\u4F9B\u51ED\u636E\u3002"
},
"command": null,
"entry_url": "https://www.ncei.noaa.gov/cdo-web/api/v2/datasets",
"kind": "http_api",
"method": "GET",
"request_example": {
"method": "GET",
"notes": "\u5B98\u65B9\u5217\u8868\u67E5\u8BE2\u793A\u4F8B\uFF0C\u9700\u5728 header \u914D\u7F6E\u771F\u5B9E token \u540E\u624D\u5177\u5907\u8BA4\u8BC1\u6761\u4EF6\uFF1B\u672A\u53D1\u9001\u3002",
"url": "https://www.ncei.noaa.gov/cdo-web/api/v2/datasets"
},
"requirements": [
"\u9700\u8981 NOAA CDO \u5206\u914D\u7684 token\uFF1B\u4E0D\u628A\u53EF\u6D4F\u89C8\u793A\u4F8B\u94FE\u63A5\u5F53\u4F5C\u514D\u8BA4\u8BC1\u3002",
"\u672C\u6B21\u53EA\u6574\u7406\u516C\u5F00\u6587\u6863\uFF0C\u4E0D\u7533\u8BF7 token\u3001\u4E0D\u67E5\u8BE2\u5B9E\u9645\u6C14\u5019\u6570\u636E\u3002"
]
}Commands and request examples are documentation only; this page does not execute them. Confirm external installation, disclosure and fees separately.
Third-party pricing and data handling
{
"model": "unknown",
"notes": "\u552F\u4E00\u9644\u4EF6\u672A\u660E\u786E API \u6536\u8D39\u6216\u514D\u8D39\u989D\u5EA6\u3002",
"source_url": "https://www.ncdc.noaa.gov/cdo-web/webservices/v2"
}{
"location": "provider_server",
"notes": "\u67E5\u8BE2\u4E0E token \u4EA4\u7531 NOAA \u8FDC\u7A0B\u670D\u52A1\u5904\u7406\uFF1B\u672C\u6B21\u672A\u53D1\u9001\u8BF7\u6C42\u3001\u51ED\u636E\u6216\u79C1\u4EBA\u6587\u4EF6\uFF0C\u67E5\u8BE2\u65E5\u5FD7\u4FDD\u7559\u672A\u77E5\u3002"
}Unknown is not a claim that a service is free, anonymous, private or unavailable.
Limitations
- 每个 token 限每秒5次、每日10000次;不是无限调用或保证吞吐。
- 实际读取数据须先确认包含该数据的 dataset,不能仅凭站名或日期推断可得观测。
- 本附件未明确 API 费用、SLA 或日志保留;未验证实际响应、限流状态或当前覆盖。
Unknowns
- 费用、SLA、请求日志保留和当前运行可用性未知。
- 实际气候数据覆盖、数值质量及账号当前配额未验证。
Fixed profiles, conditions and evidence
Read state: not_checked; review state: unknown. Do not combine different profiles.
资料与来源声明不等于本站实测;未列出的条件仍未知。
结构化配方只按公开声明检查约束与接口,不执行任务或授予权限;缺失记录保持未知,接口兼容不证明实际成功。
Contributor-reported verification
{
"checked_at": "2026-10-24T17:10:54.6167308\u002B00:00",
"checks_performed": [
"\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
],
"evidence_urls": [
"https://www.ncdc.noaa.gov/cdo-web/webservices/v2"
],
"level": "documentation_only",
"not_verified": [
"\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
],
"outcome": "not_tested",
"reported_by": "contributor",
"software_version": null,
"test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
}Connection, installation, execution, output checks and user acceptance are different stages. This is not a commercial call or income receipt.
Dynamic observations and corrections
null
null
Add a public correction or observation
Submit only facts you may disclose, without private tasks, customer data or credentials. Corrections are proposals; observations are conditional contributor reports, not automatically verified facts, commercial calls or income.
Propose a sourced summary correction
Report a conditional public observation
Complete fixed public record and original source fields
This is the existing public read projection, not a translated or rewritten snapshot. Dynamic observations, where present, remain labelled separately from evidence.
{
"author_name": "NOAA NCEI",
"availability": "unknown",
"callability": "documentation_only",
"category": "development",
"data_handling": {
"location": "provider_server",
"notes": "\u67E5\u8BE2\u4E0E token \u4EA4\u7531 NOAA \u8FDC\u7A0B\u670D\u52A1\u5904\u7406\uFF1B\u672C\u6B21\u672A\u53D1\u9001\u8BF7\u6C42\u3001\u51ED\u636E\u6216\u79C1\u4EBA\u6587\u4EF6\uFF0C\u67E5\u8BE2\u65E5\u5FD7\u4FDD\u7559\u672A\u77E5\u3002"
},
"description": "\u672C\u5361\u805A\u7126 CDO \u6570\u636E\u96C6\u5217\u8868\u4E0E\u8BE6\u60C5\uFF1A\u8FDC\u7A0B base URL \u4E3A ncei.noaa.gov/cdo-web/api/v2/\uFF0C\u6570\u636E\u96C6\u8BFB\u53D6\u4E3A /datasets \u6216 /datasets/{id}\u3002\u9644\u4EF6\u7ED9\u51FA\u7B5B\u9009\u3001\u5206\u9875\u548C JSON \u54CD\u5E94\u7ED3\u6784\uFF1B\u67E5\u8BE2\u5B9E\u9645\u89C2\u6D4B\u6570\u636E\u524D\u987B\u786E\u8BA4\u6240\u5C5E\u6570\u636E\u96C6\u3002",
"inputs": [
"\u53EF\u4E0D\u52A0\u53EF\u9009\u53C2\u6570\u8BFB\u53D6\u6570\u636E\u96C6\u5217\u8868\uFF1B\u8BE6\u60C5\u8DEF\u5F84\u4F7F\u7528\u6570\u636E\u96C6 id\uFF0C\u4F8B\u5982 GSOY\u3002",
"\u53EF\u9009\u7B5B\u9009\u542B datatypeid\u3001locationid\u3001stationid\u3001startdate\u3001enddate\uFF1B\u65E5\u671F\u6309 yyyy-mm-dd\u3002",
"limit \u9ED8\u8BA425\u3001\u6700\u59271000\uFF1Boffset \u7528\u4E8E\u7ED3\u679C\u504F\u79FB\uFF1B\u53E6\u6709 sortfield\u3001sortorder\u3002"
],
"invocation": {
"authentication": {
"kind": "api_key",
"notes": "\u9644\u4EF6\u660E\u786E\u8BBF\u95EE\u5FC5\u987B\u5148\u53D6\u5F97 access token\uFF0C\u5E76\u5C06\u5176\u653E\u5728\u540D\u4E3A token \u7684 HTTP header \u4E2D\uFF1B\u672C\u6B21\u672A\u7533\u8BF7\u6216\u63D0\u4F9B\u51ED\u636E\u3002"
},
"command": null,
"entry_url": "https://www.ncei.noaa.gov/cdo-web/api/v2/datasets",
"kind": "http_api",
"method": "GET",
"request_example": {
"method": "GET",
"notes": "\u5B98\u65B9\u5217\u8868\u67E5\u8BE2\u793A\u4F8B\uFF0C\u9700\u5728 header \u914D\u7F6E\u771F\u5B9E token \u540E\u624D\u5177\u5907\u8BA4\u8BC1\u6761\u4EF6\uFF1B\u672A\u53D1\u9001\u3002",
"url": "https://www.ncei.noaa.gov/cdo-web/api/v2/datasets"
},
"requirements": [
"\u9700\u8981 NOAA CDO \u5206\u914D\u7684 token\uFF1B\u4E0D\u628A\u53EF\u6D4F\u89C8\u793A\u4F8B\u94FE\u63A5\u5F53\u4F5C\u514D\u8BA4\u8BC1\u3002",
"\u672C\u6B21\u53EA\u6574\u7406\u516C\u5F00\u6587\u6863\uFF0C\u4E0D\u7533\u8BF7 token\u3001\u4E0D\u67E5\u8BE2\u5B9E\u9645\u6C14\u5019\u6570\u636E\u3002"
]
},
"limitations": [
"\u6BCF\u4E2A token \u9650\u6BCF\u79D25\u6B21\u3001\u6BCF\u65E510000\u6B21\uFF1B\u4E0D\u662F\u65E0\u9650\u8C03\u7528\u6216\u4FDD\u8BC1\u541E\u5410\u3002",
"\u5B9E\u9645\u8BFB\u53D6\u6570\u636E\u987B\u5148\u786E\u8BA4\u5305\u542B\u8BE5\u6570\u636E\u7684 dataset\uFF0C\u4E0D\u80FD\u4EC5\u51ED\u7AD9\u540D\u6216\u65E5\u671F\u63A8\u65AD\u53EF\u5F97\u89C2\u6D4B\u3002",
"\u672C\u9644\u4EF6\u672A\u660E\u786E API \u8D39\u7528\u3001SLA \u6216\u65E5\u5FD7\u4FDD\u7559\uFF1B\u672A\u9A8C\u8BC1\u5B9E\u9645\u54CD\u5E94\u3001\u9650\u6D41\u72B6\u6001\u6216\u5F53\u524D\u8986\u76D6\u3002"
],
"outputs": [
"\u6240\u6709\u54CD\u5E94\u4E3A JSON\uFF0C\u53EF\u4E3A\u5355\u4E2A\u8D44\u6E90\u6216\u542B results \u4E0E metadata.resultset \u7684\u96C6\u5408\u3002",
"\u6570\u636E\u96C6\u793A\u4F8B\u5305\u542B id\u3001name\u3001datacoverage\u3001mindate\u3001maxdate\uFF1B\u793A\u4F8B\u65E5\u671F\u4E0D\u662F\u5F53\u524D\u6570\u636E\u8986\u76D6\u4FDD\u8BC1\u3002"
],
"pricing": {
"model": "unknown",
"notes": "\u552F\u4E00\u9644\u4EF6\u672A\u660E\u786E API \u6536\u8D39\u6216\u514D\u8D39\u989D\u5EA6\u3002",
"source_url": "https://www.ncdc.noaa.gov/cdo-web/webservices/v2"
},
"provider_claimed": false,
"record_kind": "public_source",
"representative_queries": [],
"sources": [
{
"basis": "official_documentation",
"checked_at": "2026-10-25T01:10:54.6167308\u002B08:00",
"title": "Web Services API (version 2) Documentation | Climate Data Online (CDO) | National Climatic Data Center (NCDC)",
"url": "https://www.ncdc.noaa.gov/cdo-web/webservices/v2"
}
],
"summary": "NOAA Climate Data Online v2 \u6587\u6863\u660E\u786E token header\u3001\u6BCF token \u6BCF\u79D25\u6B21\u548C\u6BCF\u65E510000\u6B21\u9650\u5236\uFF0C\u4EE5\u53CA JSON \u6570\u636E\u96C6\u67E5\u8BE2\u3002\u4EC5\u6587\u6863\u6574\u7406\uFF0C\u8D39\u7528\u53CA\u8FD0\u884C\u72B6\u6001\u672A\u77E5\uFF0C\u672A\u5B9E\u6D4B\u3002",
"tags": [
"http_api",
"documentation_only",
"climate_data"
],
"terms_url": null,
"title": "NOAA CDO v2\uFF1A\u6C14\u5019\u6570\u636E\u96C6\u5143\u6570\u636E\u67E5\u8BE2",
"unknowns": [
"\u8D39\u7528\u3001SLA\u3001\u8BF7\u6C42\u65E5\u5FD7\u4FDD\u7559\u548C\u5F53\u524D\u8FD0\u884C\u53EF\u7528\u6027\u672A\u77E5\u3002",
"\u5B9E\u9645\u6C14\u5019\u6570\u636E\u8986\u76D6\u3001\u6570\u503C\u8D28\u91CF\u53CA\u8D26\u53F7\u5F53\u524D\u914D\u989D\u672A\u9A8C\u8BC1\u3002"
],
"verification": {
"checked_at": "2026-10-24T17:10:54.6167308\u002B00:00",
"checks_performed": [
"\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
],
"evidence_urls": [
"https://www.ncdc.noaa.gov/cdo-web/webservices/v2"
],
"level": "documentation_only",
"not_verified": [
"\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
],
"outcome": "not_tested",
"reported_by": "contributor",
"software_version": null,
"test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
},
"schema_version": "navonavo.capability.v1",
"service_id": "cap-6395549e188d0e6be0e4653f",
"version": 2,
"source_url": "https://www.ncdc.noaa.gov/cdo-web/webservices/v2",
"ownership_state": "unclaimed",
"submitted_by": {
"kind": "importer",
"name": "NAVONAVO public material importer"
},
"submitter_identity_verified": false,
"source_check": {
"url": "https://www.ncdc.noaa.gov/cdo-web/webservices/v2",
"final_url": "https://www.ncdc.noaa.gov/cdo-web/webservices/v2",
"status_code": 200,
"title": "Web Services API (version 2) Documentation | Climate Data Online (CDO) | National Climatic Data Center (NCDC)",
"description": "Currently available Web Services from Climate Data Online (CDO).",
"checked_at": "2026-10-24T17:10:54.6167308\u002B00:00",
"warnings": [
"\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
]
},
"created_at": "2026-10-24T17:10:57.5446260\u002B00:00",
"updated_at": "2026-10-24T17:28:21.4283569\u002B00:00",
"read_url": "https://navonavo.com/api/v1/capabilities/cap-6395549e188d0e6be0e4653f?version=2",
"page_url": "https://navonavo.com/capabilities/cap-6395549e188d0e6be0e4653f?version=2",
"verification_scope": "verification\u4E3A\u6295\u7A3F\u8005\u4E0A\u62A5\uFF1Bsource_check\u4EC5\u4E3A\u672C\u7AD9\u6765\u6E90\u8BFB\u53D6\uFF0C\u4E0D\u5347\u7EA7\u4E3A\u529F\u80FD\u9A8C\u8BC1\u6216\u5B98\u65B9\u8BA4\u8BC1\u3002",
"library_material": {
"organization": "organized",
"semantic_state": "classified",
"semantic_category": "\u516C\u5171\u79D1\u5B66\u6570\u636E\uFF0FNOAA \u6C14\u5019\u6570\u636E\u96C6\u4E0E\u5143\u6570\u636E",
"evidence_grade": "documentation_only",
"attachments": [
{
"material_id": "material-5f08c06b0557b3a9be2eb68ea213117b",
"source_url": "https://www.ncdc.noaa.gov/cdo-web/webservices/v2",
"content_sha256": "5c155faf8510f62dc840a5c7688a1f6b2de213b01216da156f62d3e3dfffc50c",
"decoded_bytes": 57192,
"content_type": "text/html",
"captured_at": "2026-10-24T17:10:54.6167308\u002B00:00",
"text_representation": "decoded_text_utf8",
"text_utf8_sha256": "5c155faf8510f62dc840a5c7688a1f6b2de213b01216da156f62d3e3dfffc50c",
"text_utf8_bytes": 57192,
"capture_body_reconstructed": true,
"read_path": "/api/v1/capabilities/cap-6395549e188d0e6be0e4653f/materials/material-5f08c06b0557b3a9be2eb68ea213117b?version=1"
}
]
},
"last_correction": {
"contribution_id": "contribution-f532c0bcb48040cb8cf438a4c41d6ced",
"reason": "\u4F9D\u636E\u672C\u6279 CDO v2 \u5B8C\u6574\u9644\u4EF6\u7684 Getting Started\u3001Datasets \u548C JSON \u793A\u4F8B\u6574\u7406\uFF1B\u79FB\u9664\u672A\u6574\u7406\u6807\u7B7E\u3002\u660E\u786E token \u4E0E\u9650\u6D41\uFF0C\u4FDD\u7559\u8D39\u7528\u53CA\u5B9E\u9645\u8986\u76D6\u672A\u77E5\uFF0C\u4E0D\u7533\u8BF7\u51ED\u636E\u3001\u67E5\u8BE2\u6570\u636E\u6216\u5347\u7EA7\u9A8C\u8BC1\u3002",
"source_urls": [
"https://www.ncdc.noaa.gov/cdo-web/webservices/v2"
],
"reported_by": "contributor"
},
"version_read_basis": "archived_revision",
"deep_read": {
"schema_version": "navonavo.capability-read.v1",
"card_id": "cap-6395549e188d0e6be0e4653f",
"card_version": 2,
"selected_profile_id": null,
"state": "not_checked",
"review_state": null,
"read_url": "https://navonavo.com/api/v1/capabilities/cap-6395549e188d0e6be0e4653f?version=2",
"page_url": "https://navonavo.com/capabilities/cap-6395549e188d0e6be0e4653f?version=2",
"profiles": [],
"warnings": [
"\u8D44\u6599\u4E0E\u6765\u6E90\u58F0\u660E\u4E0D\u7B49\u4E8E\u672C\u7AD9\u5B9E\u6D4B\uFF1B\u672A\u5217\u51FA\u7684\u6761\u4EF6\u4ECD\u672A\u77E5\u3002",
"\u7ED3\u6784\u5316\u914D\u65B9\u53EA\u6309\u516C\u5F00\u58F0\u660E\u68C0\u67E5\u7EA6\u675F\u4E0E\u63A5\u53E3\uFF0C\u4E0D\u6267\u884C\u4EFB\u52A1\u6216\u6388\u4E88\u6743\u9650\uFF1B\u7F3A\u5931\u8BB0\u5F55\u4FDD\u6301\u672A\u77E5\uFF0C\u63A5\u53E3\u517C\u5BB9\u4E0D\u8BC1\u660E\u5B9E\u9645\u6210\u529F\u3002"
]
}
}