eCFR (независимый издатель) (предварительная версия)
Кодекс США федеральных нормативных актов, метаданные регулирования и версии регулирования на определенный момент времени. Доступно через Office публикации для государственных организаций (GPO).
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Премия | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | Дэн Романо |
| URL | https://developments.substack.com |
| Адрес электронной почты | dan.romano@swolcat.com |
| Метаданные соединителя | |
|---|---|
| Publisher | Дэн Романо |
| Веб-сайт | 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 по ключевым словам и фильтрам по дате или другим критериям. |
| Получение XML полного регулирования |
Возвращает полное XML-содержимое для заданного заголовка по указанной дате моментального снимка CFR. |
| Получение версий контента для заголовка |
Возвращает список исторических версий содержимого для определенного заголовка CFR. |
| Получение всех заголовков CFR |
Возвращает список всех текущих названий CFR, включая их имена, журнал изменений и состояние up-to-date. |
| Получение исправлений CFR |
Возвращает список исторических исправлений для CFR, включая ссылки на федеральные реестры, заголовки и метаданные иерархии. |
| Получение исправлений CFR для определенного заголовка |
Возвращает исправления для определенного заголовка CFR, включая ссылки на федеральные реестры и метаданные структурной иерархии. |
| Получение происхождения названия CFR для заданной даты |
Возвращает полную иерархию нормативных требований (заголовок к разделу) для определенного заголовка по заданной дате. |
| Получение списка агентств CFR |
Возвращает все учреждения, которые отображаются в CFR, включая дочерние и заголовки или ссылки на главу. |
| Получение счетчиков результатов поиска по иерархии CFR |
Возвращает количество результатов поиска CFR, распределенных по иерархическим уровням (заголовок, глава, часть и т. д.). |
Поиск результатов CFR
Поиск разделов CFR по ключевым словам и фильтрам по дате или другим критериям.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Поисковый запрос
|
query | True | string |
Термин поиска для запроса в содержимом CFR. |
|
Изменено после
|
last_modified_on_or_after | date |
Возвращает только результаты, измененные по дате или после этой даты (гггг-MM-DD). |
|
|
Результаты на страницу
|
per_page | integer |
Количество результатов на странице (по умолчанию — 20). |
|
|
Номер страницы
|
page | integer |
Номер страницы для получения. |
|
|
Порядок сортировки
|
order | string |
Сортировка результатов по релевантности или дате. |
|
|
Режим разбиения на страницы
|
paginate_by | string |
Метод разбиения на страницы. Должно быть "результатом". |
Возвращаемое значение
Получение XML полного регулирования
Возвращает полное XML-содержимое для заданного заголовка по указанной дате моментального снимка CFR.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дата моментального снимка
|
date | True | string |
Дата версии CFR (например, 2025-05-16) |
|
Заголовок CFR
|
title | True | string |
Номер заголовка CFR (например, 21) |
|
Субтитры
|
subtitle | string |
Подзаголовок структуры CFR |
|
|
Глава
|
chapter | string |
Глава структуры CFR |
|
|
Вложенный цепочка
|
subchapter | string |
Вложенный фрагмент структуры CFR |
|
|
Часть
|
part | string |
Часть структуры CFR |
|
|
Подчастие
|
subpart | string |
Вложенная часть структуры CFR |
|
|
Секция
|
section | string |
Раздел структуры CFR |
|
|
Приложение
|
appendix | string |
Приложение структуры CFR |
Возвращаемое значение
- response
- file
Получение версий контента для заголовка
Возвращает список исторических версий содержимого для определенного заголовка CFR.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Заголовок CFR
|
title | True | string |
Номер заголовка CFR (например, 2, 22, 50) |
|
Дата проблемы в
|
issue_date[on] | string |
Возврат содержимого, добавленного именно на эту дату (гггг-MM-DD) |
|
|
Дата выпуска до или включено
|
issue_date[lte] | string |
Возврат содержимого, добавленного до этой даты (гггг-MM-DD) |
|
|
Дата выпуска после или включено
|
issue_date[gte] | string |
Возврат содержимого, добавленного или после этой даты (гггг-MM-DD) |
|
|
Субтитры
|
subtitle | string |
Буква подзаголовок в верхнем регистре (например, "A", "B" ) |
|
|
Глава
|
chapter | string |
Римские цифры или цифры для главы (например, "I", "2" ) |
|
|
Вложенный цепочка
|
subchapter | string |
Код подчаптера (например, "A", "B", с необязательным дефисом или символом подчеркивания) |
|
|
Часть
|
part | string |
Идентификатор части CFR (например, 3474) |
|
|
Подчастие
|
subpart | string |
Код подпартии (например, "B") |
|
|
Секция
|
section | string |
Раздел CFR (например, '3474.20') |
|
|
Приложение
|
appendix | string |
Справочник по приложению (например, App. A') |
Возвращаемое значение
Получение всех заголовков CFR
Возвращает список всех текущих названий CFR, включая их имена, журнал изменений и состояние up-to-date.
Возвращаемое значение
- Тело
- CfrTitlesResponse
Получение исправлений CFR
Возвращает список исторических исправлений для CFR, включая ссылки на федеральные реестры, заголовки и метаданные иерархии.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Дата моментального снимка
|
date | string |
Возвращаемые исправления, опубликованные по заданной дате (гггг-mm-dd) |
|
|
Номер заголовка CFR
|
title | integer |
Ограничение результатов определенным номером заголовка CFR |
|
|
Дата действия исправления
|
error_corrected_date | string |
Ограничение результатов на исправления с заданной датой действующей даты (гггг-mm-dd) |
Возвращаемое значение
- Тело
- CorrectionResponse
Получение исправлений CFR для определенного заголовка
Возвращает исправления для определенного заголовка CFR, включая ссылки на федеральные реестры и метаданные структурной иерархии.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Номер заголовка CFR
|
title | True | integer |
Номер заголовка CFR (например, 6, 7, 22) |
Возвращаемое значение
- Тело
- CorrectionResponse
Получение происхождения названия CFR для заданной даты
Возвращает полную иерархию нормативных требований (заголовок к разделу) для определенного заголовка по заданной дате.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Date
|
date | True | string |
Дата моментального снимка для получения происхождения (гггг-MM-DD) |
|
Заголовок CFR
|
title | True | string |
Номер заголовка CFR (например, 2, 22, 50) |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
происхождение
|
ancestry | array of AncestryItem |
Получение списка агентств CFR
Возвращает все учреждения, которые отображаются в CFR, включая дочерние и заголовки или ссылки на главу.
Возвращаемое значение
- Тело
- AgencyResponse
Получение счетчиков результатов поиска по иерархии CFR
Возвращает количество результатов поиска CFR, распределенных по иерархическим уровням (заголовок, глава, часть и т. д.).
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Поисковый запрос
|
query | True | string |
Ключевое слово или фраза для поиска в базе данных CFR. |
|
Фильтрация по агентствам slugs
|
agency_slugs | string |
Разделенный запятыми список агентств slugs (например, "epa,doe,faa"). |
|
|
Дата моментального снимка
|
date | date |
Ограничить результаты содержимого, присутствующих на этой дате (ГГГГ-MM-DD). |
|
|
Изменено после даты
|
last_modified_after | date |
Ограничение результатов на содержимое, измененное после этой даты (гггг-MM-DD). |
|
|
Изменено или после
|
last_modified_on_or_after | date |
Ограничение результатов на содержимое, измененное по дате или после этой даты (гггг-MM-DD). |
|
|
Изменено до даты
|
last_modified_before | date |
Ограничение результатов на содержимое, измененное до этой даты (гггг-MM-DD). |
|
|
Изменено или раньше
|
last_modified_on_or_before | date |
Ограничить результаты контентом, измененным до этой даты (гггг-MM-DD). |
Возвращаемое значение
Определения
Родословнаяitem
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
type
|
type | string | |
|
label
|
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 | |
|
part
|
content_versions.part | string | |
|
подпартий
|
content_versions.subpart | string | |
|
title
|
content_versions.title | string | |
|
type
|
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 | |
|
Гтэ
|
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 |
АгентствоResponse
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Агентств
|
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 |
ИсправлениеReferenceHierarchy
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
title
|
title | string | |
|
подзаголовок
|
subtitle | string | |
|
глава
|
chapter | string | |
|
part
|
part | string | |
|
подпартий
|
subpart | string | |
|
section
|
section | string |
ИсправлениеReference
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
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 |
ИсправлениеResponse
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
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 | |
|
type
|
results.type | string | |
|
иерархия
|
results.hierarchy | object | |
|
hierarchy_headings
|
results.hierarchy_headings | object | |
|
Заголовки
|
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
|
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 | |
|
count
|
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 | |
|
count
|
children.children.count | float | |
|
max_score
|
children.children.max_score | float |
file
Это базовый тип данных file.