eCFR (Independent Publisher) (versão prévia)
O Código dos EUA de regulamentos federais, metadados de regulamentação e versões de regulamentação pontuais. Disponibilizado por meio do GPO (Government Publishing Office).
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Dan Romano |
| URL | https://developments.substack.com |
| dan.romano@swolcat.com |
| Metadados do conector | |
|---|---|
| Publicador | Dan Romano |
| Site | https://www.ecfr.gov/reader-aids/ecfr-developer-resources |
| Política de privacidade | https://www.ecfr.gov/reader-aids/government-policy-and-ofr-procedures/privacy |
| Categorias | Gestão de empresas |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Obter a ancestralidade do título CFR para uma data determinada |
Retorna a hierarquia regulatória completa (título a seção) para um título específico em uma determinada data. |
| Obter contagens de resultados de pesquisa por hierarquia cfr |
Retorna o número de resultados de pesquisa cfr distribuídos entre níveis hierárquicos (título, capítulo, parte etc.). |
| Obter correções de CFR |
Retorna uma lista de correções históricas para o CFR, incluindo citações do Registro Federal, títulos e metadados de hierarquia. |
| Obter correções de CFR para um título específico |
Retorna correções para um título CFR específico, incluindo referências do Registro Federal e metadados de hierarquia estrutural. |
| Obter lista de agências CFR |
Retorna todas as agências que aparecem no CFR, incluindo referências de filhos e título/capítulo. |
| Obter todos os títulos de CFR |
Retorna uma lista de todos os títulos cfr atuais, incluindo seus nomes, histórico de alterações e status de data up-to. |
| Obter versões de conteúdo para um título |
Retorna uma lista de versões de conteúdo histórico para um título CFR específico. |
| Obter XML de regulação completa |
Retorna conteúdo XML completo para um determinado título em uma data de instantâneo cfr especificada. |
| Pesquisar resultados do CFR |
Pesquise seções CFR por palavra-chave e filtre por data ou outros critérios. |
Obter a ancestralidade do título CFR para uma data determinada
Retorna a hierarquia regulatória completa (título a seção) para um título específico em uma determinada data.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Date
|
date | True | string |
A data do instantâneo para a qual recuperar a ancestralidade (YYYY-MM-DD) |
|
Título do CFR
|
title | True | string |
O número do título cfr (por exemplo, 2, 22, 50) |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ascendência
|
ancestry | array of AncestryItem |
Obter contagens de resultados de pesquisa por hierarquia cfr
Retorna o número de resultados de pesquisa cfr distribuídos entre níveis hierárquicos (título, capítulo, parte etc.).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Consulta de pesquisa
|
query | True | string |
A palavra-chave ou frase a ser pesquisada no banco de dados CFR. |
|
Filtrar por lesmas de agência
|
agency_slugs | string |
Lista separada por vírgulas de lesmas da agência (por exemplo, "epa, doe,faa"). |
|
|
Data do instantâneo
|
date | date |
Limite os resultados ao conteúdo presente nesta data (YYYY-MM-DD). |
|
|
Modificado após a data
|
last_modified_after | date |
Limite os resultados ao conteúdo modificado após esta data (YYYY-MM-DD). |
|
|
Modificado em ou após
|
last_modified_on_or_after | date |
Limite os resultados ao conteúdo modificado em ou após esta data (YYYY-MM-DD). |
|
|
Modificado antes da data
|
last_modified_before | date |
Limitar os resultados ao conteúdo modificado antes desta data (YYYY-MM-DD). |
|
|
Modificado em ou antes
|
last_modified_on_or_before | date |
Limite os resultados ao conteúdo modificado em ou antes desta data (YYYY-MM-DD). |
Retornos
- Corpo
- HierarchyCountResponse
Obter correções de CFR
Retorna uma lista de correções históricas para o CFR, incluindo citações do Registro Federal, títulos e metadados de hierarquia.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Data do instantâneo
|
date | string |
Retornar correções publicadas a partir de uma determinada data (yyyy-mm-dd) |
|
|
Número do título cfr
|
title | integer |
Limitar os resultados a um número de título cfr específico |
|
|
Data de efetivação da correção
|
error_corrected_date | string |
Limitar os resultados a correções com uma determinada data efetiva de correção (yyy-mm-dd) |
Retornos
- Corpo
- CorrectionResponse
Obter correções de CFR para um título específico
Retorna correções para um título CFR específico, incluindo referências do Registro Federal e metadados de hierarquia estrutural.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Número do título cfr
|
title | True | integer |
O número do título cfr (por exemplo, 6, 7, 22) |
Retornos
- Corpo
- CorrectionResponse
Obter lista de agências CFR
Retorna todas as agências que aparecem no CFR, incluindo referências de filhos e título/capítulo.
Retornos
- Corpo
- AgencyResponse
Obter todos os títulos de CFR
Retorna uma lista de todos os títulos cfr atuais, incluindo seus nomes, histórico de alterações e status de data up-to.
Retornos
- Corpo
- CfrTitlesResponse
Obter versões de conteúdo para um título
Retorna uma lista de versões de conteúdo histórico para um título CFR específico.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Título do CFR
|
title | True | string |
O número do título cfr (por exemplo, 2, 22, 50) |
|
Data do problema em
|
issue_date[on] | string |
Retornar conteúdo adicionado exatamente nesta data (YYYY-MM-DD) |
|
|
Data do problema antes ou em diante
|
issue_date[lte] | string |
Retornar o conteúdo adicionado em ou antes desta data (YYYY-MM-DD) |
|
|
Data do problema após ou ativada
|
issue_date[gte] | string |
Retornar o conteúdo adicionado em ou após esta data (YYYY-MM-DD) |
|
|
Subtítulo
|
subtitle | string |
Letra de subtítulo maiúscula (por exemplo, 'A', 'B') |
|
|
Capítulo
|
chapter | string |
Numerais ou dígitos romanos para o capítulo (por exemplo, 'I', '2') |
|
|
Subcapítulo
|
subchapter | string |
Código de subchapter (por exemplo, 'A', 'B', com traço ou sublinhado opcional) |
|
|
Parte
|
part | string |
Identificador de parte CFR (por exemplo, '3474') |
|
|
Subparte
|
subpart | string |
Código de subparte (por exemplo, 'B') |
|
|
Seção
|
section | string |
Seção CFR (por exemplo, '3474.20') |
|
|
Apêndice
|
appendix | string |
Referência de apêndice (por exemplo, 'App. A') |
Retornos
- Corpo
- ContentVersionsResponse
Obter XML de regulação completa
Retorna conteúdo XML completo para um determinado título em uma data de instantâneo cfr especificada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Data do instantâneo
|
date | True | string |
Data da versão cfr (por exemplo, 2025-05-16) |
|
Título do CFR
|
title | True | string |
Número do título do CFR (por exemplo, 21) |
|
Subtítulo
|
subtitle | string |
Subtítulo da estrutura CFR |
|
|
Capítulo
|
chapter | string |
Capítulo da estrutura CFR |
|
|
Subcapítulo
|
subchapter | string |
Subchapter da estrutura CFR |
|
|
Parte
|
part | string |
Parte da estrutura CFR |
|
|
Subparte
|
subpart | string |
Subpart da estrutura CFR |
|
|
Seção
|
section | string |
Seção da estrutura CFR |
|
|
Apêndice
|
appendix | string |
Apêndice da estrutura CFR |
Retornos
- response
- file
Pesquisar resultados do CFR
Pesquise seções CFR por palavra-chave e filtre por data ou outros critérios.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Consulta de pesquisa
|
query | True | string |
O termo de pesquisa a ser consultado no conteúdo do CFR. |
|
Modificado após
|
last_modified_on_or_after | date |
Retornar somente os resultados modificados em ou após esta data (YYYY-MM-DD). |
|
|
Resultados por página
|
per_page | integer |
Número de resultados por página (o padrão é 20). |
|
|
Número da página
|
page | integer |
O número da página a ser recuperado. |
|
|
Ordem de classificação
|
order | string |
Classificar os resultados por relevância ou data. |
|
|
Modo de paginação
|
paginate_by | string |
Método de paginação. Deve ser "resultados". |
Retornos
- Corpo
- SearchResultsResponse
Definições
AncestryItem
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
tipo
|
type | string | |
|
etiqueta
|
label | string | |
|
label_level
|
label_level | string | |
|
label_description
|
label_description | string | |
|
identificador
|
identifier | string | |
|
reservado
|
reserved | boolean | |
|
section_range
|
section_range | string |
ContentVersionsResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
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 | |
|
identificador
|
content_versions.identifier | string | |
|
nome
|
content_versions.name | string | |
|
part
|
content_versions.part | string | |
|
Subparte
|
content_versions.subpart | string | |
|
title
|
content_versions.title | string | |
|
tipo
|
content_versions.type | string | |
|
substantivo
|
content_versions.substantive | boolean | |
|
removidas
|
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
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
número
|
number | number | |
|
nome
|
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 | |
|
reservado
|
reserved | boolean |
CfrTitlesMeta
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
date
|
date | string | |
|
import_in_progress
|
import_in_progress | boolean |
CfrTitlesResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Títulos
|
titles | array of CfrTitle | |
|
meta
|
meta | CfrTitlesMeta |
AgencyResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Agências
|
agencies | array of Agency |
AgencyReference
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
title
|
title | integer |
Número do título do CFR |
|
capítulo
|
chapter | string |
Designação de capítulo cfr |
Agência
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
nome
|
name | string | |
|
short_name
|
short_name | string | |
|
display_name
|
display_name | string | |
|
sortable_name
|
sortable_name | string | |
|
lesma
|
slug | string | |
|
cfr_references
|
cfr_references | array of AgencyReference | |
|
children
|
children | array of Agency |
CorrectionReferenceHierarchy
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
title
|
title | string | |
|
subtítulo
|
subtitle | string | |
|
capítulo
|
chapter | string | |
|
part
|
part | string | |
|
Subparte
|
subpart | string | |
|
section
|
section | string |
CorrectionReference
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
cfr_reference
|
cfr_reference | string | |
|
hierarquia
|
hierarchy | CorrectionReferenceHierarchy |
Correção
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
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 | |
|
posição
|
position | number | |
|
display_in_toc
|
display_in_toc | boolean | |
|
title
|
title | number | |
|
ano
|
year | number | |
|
last_modified
|
last_modified | string |
CorrectionResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ecfr_corrections
|
ecfr_corrections | array of Correction |
SearchResultsResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
results
|
results | array of object | |
|
starts_on
|
results.starts_on | string | |
|
ends_on
|
results.ends_on | string | |
|
tipo
|
results.type | string | |
|
hierarquia
|
results.hierarchy | object | |
|
hierarchy_headings
|
results.hierarchy_headings | object | |
|
títulos
|
results.headings | object | |
|
full_text_excerpt
|
results.full_text_excerpt | string | |
|
|
results.score | float | |
|
structure_index
|
results.structure_index | number | |
|
reservado
|
results.reserved | boolean | |
|
removidas
|
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 | |
|
descrição
|
meta.description | string |
HierarchyCountResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
value
|
count.value | number | |
|
relação
|
count.relation | string | |
|
max_score
|
max_score | float | |
|
shown_count
|
shown_count | number | |
|
children
|
children | array of HierarchyNode |
HierarchyNode
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
nível
|
level | string | |
|
hierarquia
|
hierarchy | string | |
|
hierarchy_heading
|
hierarchy_heading | string | |
|
título
|
heading | string | |
|
structure_index
|
structure_index | number | |
|
count
|
count | integer | |
|
max_score
|
max_score | float | |
|
children
|
children | array of object | |
|
nível
|
children.level | string | |
|
hierarquia
|
children.hierarchy | string | |
|
hierarchy_heading
|
children.hierarchy_heading | string | |
|
título
|
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 | |
|
nível
|
children.children.level | string | |
|
hierarquia
|
children.children.hierarchy | string | |
|
hierarchy_heading
|
children.children.hierarchy_heading | string | |
|
título
|
children.children.heading | string | |
|
structure_index
|
children.children.structure_index | number | |
|
count
|
children.children.count | float | |
|
max_score
|
children.children.max_score | float |
arquivo
Esse é o tipo de dados básico 'file'.