eCFR (独立发布者) (预览版)
美国联邦法规、法规元数据和时间点监管版本。 通过政府出版办公室(GPO)提供。
此连接器在以下产品和区域中可用:
| 服务 | Class | 区域 |
|---|---|---|
| Copilot Studio | 高级 | 除以下各项外的所有 Power Automate 区域 : - 美国政府 (GCC) - 美国政府 (GCC High) - 由世纪互联运营的中国云 - 美国国防部(DoD) |
| 逻辑应用程序 | 标准 | 除以下各项外的所有 逻辑应用区域 : - Azure 政府区域 - Azure 中国区域 - 美国国防部(DoD) |
| Power Apps | 高级 | 除以下各项外的所有 Power Apps 区域 : - 美国政府 (GCC) - 美国政府 (GCC High) - 由世纪互联运营的中国云 - 美国国防部(DoD) |
| Power Automate | 高级 | 除以下各项外的所有 Power Automate 区域 : - 美国政府 (GCC) - 美国政府 (GCC High) - 由世纪互联运营的中国云 - 美国国防部(DoD) |
| 联系人 | |
|---|---|
| Name | Dan Romano |
| URL | https://developments.substack.com |
| dan.romano@swolcat.com |
| 连接器元数据 | |
|---|---|
| 发布者 | Dan Romano |
| 网站 | https://www.ecfr.gov/reader-aids/ecfr-developer-resources |
| 隐私策略 | https://www.ecfr.gov/reader-aids/government-policy-and-ofr-procedures/privacy |
| 类别 | 商业管理 |
限制
| 名称 | 调用 | 续订期 |
|---|---|---|
| 每个连接的 API 调用数 | 100 | 60 秒 |
操作
| 按 CFR 层次结构获取搜索结果计数 |
返回分布在分层级别(标题、章节、部件等)的 CFR 搜索结果数。 |
| 搜索 CFR 结果 |
按关键字搜索 CFR 部分,按日期或其他条件进行筛选。 |
| 获取 CFR 更正 |
返回 CFR 的历史更正列表,包括联邦注册引文、标题和层次结构元数据。 |
| 获取 CFR 机构列表 |
返回 CFR 中显示的所有机构,包括子级和标题/章节引用。 |
| 获取完整规范 XML |
返回指定 CFR 快照日期上给定游戏的完整 XML 内容。 |
| 获取所有 CFR 标题 |
返回所有当前 CFR 游戏的列表,包括其名称、修订历史记录和 up-to日期状态。 |
| 获取游戏的内容版本 |
返回特定 CFR 游戏的历史内容版本列表。 |
| 获取特定游戏的 CFR 更正 |
返回特定 CFR 标题的更正,包括联邦注册引用和结构层次结构元数据。 |
| 获取给定日期的 CFR 标题 Ancestry |
返回给定日期特定游戏的完整监管层次结构(标题到节)。 |
按 CFR 层次结构获取搜索结果计数
返回分布在分层级别(标题、章节、部件等)的 CFR 搜索结果数。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
搜索查询
|
query | True | string |
在 CFR 数据库中搜索的关键字或短语。 |
|
按机构筛选
|
agency_slugs | string |
以逗号分隔的机构 slugs 列表(例如,“epa,doe,faa”)。 |
|
|
快照日期
|
date | date |
将结果限制为此日期上显示的内容(YYYY-MM-DD)。 |
|
|
日期后修改
|
last_modified_after | date |
将结果限制为在此日期之后修改的内容(YYYY-MM-DD)。 |
|
|
在或之后修改
|
last_modified_on_or_after | date |
将结果限制为在此日期或之后修改的内容(YYYY-MM-DD)。 |
|
|
修改日期前
|
last_modified_before | date |
将结果限制为在此日期之前修改的内容(YYYY-MM-DD)。 |
|
|
在或之前修改
|
last_modified_on_or_before | date |
将结果限制为在此日期或日期之前修改的内容(YYYY-MM-DD)。 |
返回
搜索 CFR 结果
按关键字搜索 CFR 部分,按日期或其他条件进行筛选。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
搜索查询
|
query | True | string |
在 CFR 内容中查询的搜索词。 |
|
修改后的
|
last_modified_on_or_after | date |
仅返回在此日期或之后修改的结果(YYYY-MM-DD)。 |
|
|
每页结果数
|
per_page | integer |
每页结果数(默认值为 20)。 |
|
|
页码
|
page | integer |
要检索的页码。 |
|
|
排序方式
|
order | string |
按相关性或日期对结果进行排序。 |
|
|
分页模式
|
paginate_by | string |
分页方法。 必须是“results”。 |
返回
获取 CFR 更正
返回 CFR 的历史更正列表,包括联邦注册引文、标题和层次结构元数据。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
快照日期
|
date | string |
返回根据给定日期发布的更正(yyyy-mm-dd) |
|
|
CFR 标题编号
|
title | integer |
将结果限制为特定的 CFR 标题编号 |
|
|
更正生效日期
|
error_corrected_date | string |
将结果限制为具有给定更正生效日期的更正(yyyy-mm-dd) |
返回
- Body
- CorrectionResponse
获取 CFR 机构列表
获取完整规范 XML
返回指定 CFR 快照日期上给定游戏的完整 XML 内容。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
快照日期
|
date | True | string |
CFR 版本的日期(例如 2025-05-16) |
|
CFR 标题
|
title | True | string |
CFR 的标题编号(例如 21) |
|
副标题
|
subtitle | string |
CFR 结构的副标题 |
|
|
章
|
chapter | string |
CFR 结构的章节 |
|
|
Subchapter
|
subchapter | string |
CFR 结构的子部分 |
|
|
部件
|
part | string |
CFR 结构的一部分 |
|
|
子部分
|
subpart | string |
CFR 结构的子部分 |
|
|
Section
|
section | string |
CFR 结构的节 |
|
|
附录
|
appendix | string |
CFR 结构的附录 |
返回
- response
- file
获取所有 CFR 标题
获取游戏的内容版本
返回特定 CFR 游戏的历史内容版本列表。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
CFR 标题
|
title | True | string |
CFR 标题编号(例如 2、22、50) |
|
问题日期
|
issue_date[on] | string |
返回在此日期添加的内容(YYYY-MM-DD) |
|
|
发行日期之前或打开日期
|
issue_date[lte] | string |
返回在此日期或之前添加的内容(YYYY-MM-DD) |
|
|
问题日期之后或打开日期
|
issue_date[gte] | string |
返回在此日期或之后添加的内容(YYYY-MM-DD) |
|
|
副标题
|
subtitle | string |
大写副标题字母(例如,“A”、“B”) |
|
|
章
|
chapter | string |
章节的罗马数字或数字(例如,“I”、“2”) |
|
|
Subchapter
|
subchapter | string |
子代码(例如,具有可选短划线或下划线的“A”、“B”) |
|
|
部件
|
part | string |
CFR 部件标识符(例如,“3474”) |
|
|
子部分
|
subpart | string |
子部分代码(例如,“B”) |
|
|
Section
|
section | string |
CFR 部分(例如,“3474.20”) |
|
|
附录
|
appendix | string |
附录参考(例如,'App.A') |
返回
获取特定游戏的 CFR 更正
返回特定 CFR 标题的更正,包括联邦注册引用和结构层次结构元数据。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
CFR 标题编号
|
title | True | integer |
CFR 标题编号(例如 6、7、22) |
返回
- Body
- CorrectionResponse
获取给定日期的 CFR 标题 Ancestry
返回给定日期特定游戏的完整监管层次结构(标题到节)。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
日期
|
date | True | string |
检索祖先的快照日期(YYYY-MM-DD) |
|
CFR 标题
|
title | True | string |
CFR 标题编号(例如 2、22、50) |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
祖先
|
ancestry | array of AncestryItem |
定义
AncestryItem
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
类型
|
type | string | |
|
标签
|
label | string | |
|
label_level
|
label_level | string | |
|
label_description
|
label_description | string | |
|
标识符
|
identifier | string | |
|
保留
|
reserved | boolean | |
|
section_range
|
section_range | string |
ContentVersionsResponse
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
content_versions
|
content_versions | array of object | |
|
date
|
content_versions.date | string | |
|
amendment_date
|
content_versions.amendment_date | string | |
|
issue_date
|
content_versions.issue_date | string | |
|
标识符
|
content_versions.identifier | string | |
|
姓名
|
content_versions.name | string | |
|
部件
|
content_versions.part | string | |
|
子部分
|
content_versions.subpart | string | |
|
title
|
content_versions.title | string | |
|
类型
|
content_versions.type | string | |
|
实质性
|
content_versions.substantive | boolean | |
|
删除内容
|
content_versions.removed | boolean | |
|
title
|
meta.title | string | |
|
result_count
|
meta.result_count | string | |
|
lte
|
meta.issue_date.lte | string | |
|
gte
|
meta.issue_date.gte | string | |
|
latest_amendment_date
|
meta.latest_amendment_date | string | |
|
latest_issue_date
|
meta.latest_issue_date | string |
CfrTitle
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
数字
|
number | number | |
|
姓名
|
name | string | |
|
latest_amended_on
|
latest_amended_on | string | |
|
latest_issue_date
|
latest_issue_date | string | |
|
up_to_date_as_of
|
up_to_date_as_of | string | |
|
保留
|
reserved | boolean |
CfrTitlesMeta
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
date
|
date | string | |
|
import_in_progress
|
import_in_progress | boolean |
CfrTitlesResponse
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
标题
|
titles | array of CfrTitle | |
|
元
|
meta | CfrTitlesMeta |
AgencyResponse
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
机构
|
agencies | array of Agency |
AgencyReference
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
title
|
title | integer |
CFR 标题编号 |
|
章节
|
chapter | string |
CFR 章节指定 |
机构
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
姓名
|
name | string | |
|
short_name
|
short_name | string | |
|
display_name
|
display_name | string | |
|
sortable_name
|
sortable_name | string | |
|
鼻涕虫
|
slug | string | |
|
cfr_references
|
cfr_references | array of AgencyReference | |
|
children
|
children | array of Agency |
CorrectionReferenceHierarchy
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
title
|
title | string | |
|
字幕
|
subtitle | string | |
|
章节
|
chapter | string | |
|
部件
|
part | string | |
|
子部分
|
subpart | string | |
|
section
|
section | string |
CorrectionReference
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
cfr_reference
|
cfr_reference | string | |
|
层次结构
|
hierarchy | CorrectionReferenceHierarchy |
更正
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
id
|
id | number | |
|
cfr_references
|
cfr_references | array of CorrectionReference | |
|
corrective_action
|
corrective_action | string | |
|
error_corrected
|
error_corrected | string | |
|
error_occurred
|
error_occurred | string | |
|
fr_citation
|
fr_citation | string | |
|
位置
|
position | number | |
|
display_in_toc
|
display_in_toc | boolean | |
|
title
|
title | number | |
|
年
|
year | number | |
|
last_modified
|
last_modified | string |
CorrectionResponse
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
ecfr_corrections
|
ecfr_corrections | array of Correction |
SearchResultsResponse
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
results
|
results | array of object | |
|
starts_on
|
results.starts_on | string | |
|
ends_on
|
results.ends_on | string | |
|
类型
|
results.type | string | |
|
层次结构
|
results.hierarchy | object | |
|
hierarchy_headings
|
results.hierarchy_headings | object | |
|
headings
|
results.headings | object | |
|
full_text_excerpt
|
results.full_text_excerpt | string | |
|
|
results.score | float | |
|
structure_index
|
results.structure_index | number | |
|
保留
|
results.reserved | boolean | |
|
删除内容
|
results.removed | boolean | |
|
change_types
|
results.change_types | array of string | |
|
current_page
|
meta.current_page | number | |
|
total_pages
|
meta.total_pages | number | |
|
total_count
|
meta.total_count | number | |
|
max_score
|
meta.max_score | float | |
|
描述
|
meta.description | string |
HierarchyCountResponse
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
value
|
count.value | number | |
|
关系
|
count.relation | string | |
|
max_score
|
max_score | float | |
|
shown_count
|
shown_count | number | |
|
children
|
children | array of HierarchyNode |
HierarchyNode
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
水平仪
|
level | string | |
|
层次结构
|
hierarchy | string | |
|
hierarchy_heading
|
hierarchy_heading | string | |
|
标题
|
heading | string | |
|
structure_index
|
structure_index | number | |
|
计数
|
count | integer | |
|
max_score
|
max_score | float | |
|
children
|
children | array of object | |
|
水平仪
|
children.level | string | |
|
层次结构
|
children.hierarchy | string | |
|
hierarchy_heading
|
children.hierarchy_heading | string | |
|
标题
|
children.heading | string | |
|
structure_index
|
children.structure_index | number | |
|
计数
|
children.count | integer | |
|
max_score
|
children.max_score | float | |
|
children
|
children.children | array of object | |
|
水平仪
|
children.children.level | string | |
|
层次结构
|
children.children.hierarchy | string | |
|
hierarchy_heading
|
children.children.hierarchy_heading | string | |
|
标题
|
children.children.heading | string | |
|
structure_index
|
children.children.structure_index | number | |
|
计数
|
children.children.count | float | |
|
max_score
|
children.children.max_score | float |
文件
这是基本数据类型“file”。