Partilhar via


GSA Site Scanning (Editora Independente)

Explore informações abrangentes sobre a saúde e a conformidade dos sites federais dos EUA, oferecendo uma janela para a dinâmica e os padrões da presença federal na Web. Através de verificações automatizadas, este serviço gera dados detalhados sobre o cumprimento da política do site e as melhores práticas, melhorando a acessibilidade e a gestão dos ativos digitais governamentais.

Este conector está disponível nos seguintes produtos e regiões:

Serviço Class Regiões
Estúdio Copiloto Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Premium Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Richard Wilson
URL https://www.richardawilson.com/
Email richard.a.wilson@microsoft.com
Metadados do conector
Editora Richard Wilson
Sítio Web https://open.gsa.gov/api/site-scanning-api
Política de privacidade https://www.gsa.gov/technology/government-it-initiatives/digital-strategy/terms-of-service-for-developer-resources
Categorias Operações de TI

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Predefinição Parâmetros para criar conexão. Todas as regiões Não compartilhável

Padrão

Aplicável: Todas as regiões

Parâmetros para criar conexão.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome Tipo Description Obrigatório
Chave de API GSA securestring A chave API da GSA que pode ser obtida a partir de https://open.gsa.gov/api/site-scanning-api/ Verdade

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos

Ações

Realizar análise de sites

Executa uma análise abrangente de sites com base em vários parâmetros, como URL de destino, URL final e status da verificação.

Recuperar informações do site

Obtém detalhes sobre sites, incluindo URLs de destino e finais, propriedade, status da verificação e deteção de análise.

Recuperar informações do site por URL

Busca informações detalhadas sobre um site com base no URL especificado.

Realizar análise de sites

Executa uma análise abrangente de sites com base em vários parâmetros, como URL de destino, URL final e status da verificação.

Parâmetros

Name Chave Necessário Tipo Description
Domínio de URL de destino
target_url_domain string

O nome de domínio mais o domínio de nível superior (TLD) do domínio URL de destino. Este parâmetro especifica o ponto inicial do scanner, contrastando com o Domínio de URL Final, onde a verificação é concluída após redirecionamentos.

Domínio URL final
final_url_domain string

O nome de domínio mais o domínio de nível superior (TLD) do Domínio URL Final. O Domínio de URL Final é onde o mecanismo de varredura termina depois de seguir redirecionamentos, em contraste com o Domínio de URL de Destino.

URL final ao vivo
final_url_live boolean

Indica se a URL final está ativa retornando um código de status HTTP na família 2xx.

Redirecionamentos de URL de destino
target_url_redirects boolean

Um valor booleano que indica se a URL de destino redireciona, o que ocorre quando um código de status HTTP 3xx é retornado. Observe que os scanners têm o cache desativado, portanto, 304 códigos de status HTTP não estão presentes.

Proprietário da agência de URL de destino
target_url_agency_owner string

Especifica a agência que possui ou opera o site associado à URL de destino.

Proprietário do Bureau de URL de Destino
target_url_bureau_owner string

Especifica o bureau que possui ou opera o site associado à URL de destino.

Estado da Análise
primary_scan_status string

Captura o status da verificação do site e quaisquer razões conhecidas para falha. O valor unknown_error é reservado para erros ainda não codificados no sistema.

DAP detetado na URL final
dap_detected_final_url boolean

Um valor booleano que indica se o Digital Analytics Program (DAP) é detetado na URL final.

Devoluções

Recuperar informações do site

Obtém detalhes sobre sites, incluindo URLs de destino e finais, propriedade, status da verificação e deteção de análise.

Parâmetros

Name Chave Necessário Tipo Description
Domínio de URL de destino
target_url_domain string

O nome de domínio mais o domínio de nível superior (TLD) do domínio URL de destino. O URL de destino é onde o mecanismo de varredura começa, contrastando com o URL final, onde o mecanismo de varredura termina após redirecionamentos.

Domínio URL final
final_url_domain string

O nome de domínio mais o domínio de nível superior (TLD) do Domínio URL Final. O URL final é onde o mecanismo de varredura termina depois de seguir redirecionamentos, em contraste com o URL de destino.

URL final ao vivo
final_url_live boolean

Indica se a URL final está ativa, retornando um código de status HTTP na família 2xx.

Redirecionamentos de URL de destino
target_url_redirects boolean

Registra se a URL de destino redireciona (true se um código de status HTTP 3xx for retornado). Os scanners têm o cache desativado, portanto, 304 códigos de status estão ausentes.

Proprietário da agência de URL de destino
target_url_agency_owner string

A agência que possui ou opera o site associado ao URL de destino.

Proprietário do Bureau de URL de Destino
target_url_bureau_owner string

O bureau que possui ou opera o site associado ao URL de destino.

Estado da Análise
primary_scan_status string

Captura o status da verificação e qualquer motivo conhecido para falha. unknown_error é reservado para erros não codificados.

DAP detetado na URL final
dap_detected_final_url boolean

Indica se o Programa de Análise Digital (DAP) é detetado no URL Final.

Limite
limit integer

Especifica o número de itens a serem retornados em uma única página de resultados.

Página
page integer

Especifica o número de página dos resultados a serem recuperados.

Devoluções

Recuperar informações do site por URL

Busca informações detalhadas sobre um site com base no URL especificado.

Parâmetros

Name Chave Necessário Tipo Description
URL do site
url True string

O URL do site para recuperar informações. Isso deve incluir o nome de domínio e quaisquer componentes de caminho relevantes.

Devoluções

Definições

AnáliseDto

Name Caminho Tipo Description
Total de itens analisados
total number

O número total de itens analisados.

Total de agências analisadas
totalAgencies number

O número total de agências para as quais os sites foram analisados.

Total de Domínios Base de URL Final
totalFinalUrlBaseDomains number

O número total de domínios base de URL finais exclusivos analisados.

PaginatedWebsiteResponseDto

Name Caminho Tipo Description
Itens do site
items array of WebsiteApiResultDto

Uma variedade de resultados do site.

Link da Primeira Página
links.first string

Um link para a primeira página de resultados.

Link da última página
links.last string

Um link para a última página de resultados.

Link da próxima página
links.next string

Um link para a próxima página de resultados. Na última página de resultados, esta será uma cadeia de caracteres vazia.

Link da página anterior
links.previous string

Um link para a página anterior de resultados. Na primeira página de resultados, esta será uma cadeia de caracteres vazia.

Página Atual
meta.currentPage number

O número da página atual.

Contagem de itens
meta.itemCount number

O número de itens na matriz PaginationResponseDto.items.

Itens por página
meta.itemsPerPage number

O número de itens por página. Isso deve ser o mesmo que o parâmetro limit query.

Total de Itens
meta.totalItems number

O número total de itens que correspondem à consulta.

Total de Páginas
meta.totalPages number

O número total de páginas, calculado como floor(totalItems / itemsPerPage).

WebsiteApiResultDto

Name Caminho Tipo Description
Link canônico
canonical_link string

Indica a presença de uma marca de link canônica.

Cloud.gov Hospedagem de Páginas
cloud_dot_gov_pages boolean

Indica que o URL final está hospedado usando Cloud.gov Pages.

Sistema de Gestão de Conteúdos (CMS)
cms string

Indica o sistema de gerenciamento de conteúdo usado para hospedar a URL final.

DAP detetado na URL final
dap_detected_final_url boolean

Um booleano que representa a presença do Digital Analytics Program no URL final.

Parâmetros DAP na URL final
dap_parameters_final_url object

Um objeto com chaves de parâmetro e valores do Digital Analytics Program na URL final.

Nome do host DNS
dns_hostname string

O domínio do sistema subjacente, muitas vezes sugerindo o uso de um provedor de nuvem ou CDN.

Final URL
final_url string

O URL após qualquer redirecionamento do URL de destino.

Tipo MIME de URL final
final_url_MIMEType string

O tipo MIME da URL final extraída do cabeçalho Content-Type.

Domínio URL final
final_url_domain string

O nome de domínio + domínio de nível superior do URL final.

URL final ao vivo
final_url_live boolean

Um booleano que representa se a URL final retornou um código de status HTTP da família 2xx.

URL final mesmo domínio
final_url_same_domain boolean

Um campo booleano que representa se a URL final está no mesmo domínio que a URL de destino. Se false, isso implica um redirecionamento.

URL final mesmo site
final_url_same_website boolean

Indica se o URL final tem um caminho ou domínio diferente do URL de destino.

Código de status final do URL
final_url_status_code number

O código de status HTTP da URL final.

Final URL Website
final_url_website string

Inclui o subdomínio e o domínio de nível superior do URL final.

Presença do elemento principal no URL final
main_element_present_final_url boolean

Indica se o <elemento principal> está presente na URL final.

Abrir data de modificação do artigo do Graph no URL final
og_article_modified_final_url string

O artigo do Open Graph modificou a tag se disponível no URL final.

Open Graph Artigo Data de Publicação no URL Final
og_article_published_final_url string

A tag publicada do artigo do Open Graph, se disponível no URL final.

Abrir descrição do gráfico no URL final
og_description_final_url string

A tag de descrição do Open Graph, se encontrada no URL final.

Abrir o título do gráfico no URL final
og_title_final_url string

A tag de título do Open Graph, se encontrada no URL final.

Robots.txt Atraso de rastreamento
robots_txt_crawl_delay integer

O valor de atraso de rastreamento em segundos, se presente no arquivo robots.txt.

Robots.txt detetado
robots_txt_detected boolean

Indica se o arquivo robots.txt é detetado.

Robots.txt URL final
robots_txt_final_url string

O URL final do arquivo robots.txt após quaisquer redirecionamentos.

Robots.txt Tipo MIME de URL final
robots_txt_final_url_MIMETYPE string

O tipo MIME da página robots.txt extraída do cabeçalho Content-Type.

Robots.txt URL final ao vivo
robots_txt_final_url_live boolean

Indica se o robots.txt status HTTP da URL final está na família 2xx.

Robots.txt Tamanho final do URL em bytes
robots_txt_final_url_size_in_bytes number

O tamanho do arquivo robots.txt em bytes.

Robots.txt Código de status do URL final
robots_txt_final_url_status_code number

O código de status HTTP do URL final robots.txt.

Robots.txt redirecionamentos de URL de destino
robots_txt_target_url_redirects boolean

Indica se o destino robots.txt redirecionamentos de URL. Isso visa especificamente o arquivo robots.txt.

Data de verificação
scan_date string

A data/hora em que a varredura foi realizada.

Estado da Análise
primary_scan_status string

O status de sucesso do Core Scan.

Sitemap.xml contagem de URL
sitemap_xml_count integer

Indica o número de elementos url <> encontrados no arquivo sitemap.xml.

Sitemap.xml detetado
sitemap_xml_detected boolean

Indica se o arquivo sitemap.xml foi encontrado.

Sitemap.xml URL final
sitemap_xml_final_url string

O URL final da página sitemap.xml após quaisquer redirecionamentos.

Sitemap.xml Tipo MIME de URL final
sitemap_xml_final_url_MIMETYPE string

O tipo MIME do URL final sitemap.xml extraído do cabeçalho Content-Type.

Sitemap.xml Tamanho do arquivo de URL final
sitemap_xml_final_url_filesize integer

O tamanho do arquivo da página sitemap.xml em bytes.

Sitemap.xml URL final ao vivo
sitemap_xml_final_url_live boolean

Indica se o sitemap.xml código de status de URL final está na família 2xx.

Sitemap.xml Código de status do URL final
sitemap_xml_final_url_status_code number

O código de status HTTP da página sitemap.xml.

Sitemap.xml Contagem de URL PDF
sitemap_xml_pdf_count integer

O número de URLs que têm a extensão PDF no sitemap.xml.

Sitemap.xml redirecionamentos de URL de destino
sitemap_xml_target_url_redirects boolean

Indica se a página sitemap.xml redireciona. Isso visa especificamente o arquivo sitemap.xml.

Originado da Lista DAP
source_list_dap boolean

Indica se o Programa de Análise Digital forneceu essa URL para a Lista de URLs de Destino.

Proveniente da Lista de Domínios Federais
source_list_federal_domains boolean

Indica se a Lista de Domínios Federais forneceu essa URL para a Lista de URLs de Destino.

Proveniente de outras listas
source_list_other boolean

Indica se uma lista mantida manualmente de sites adicionais forneceu essa URL para a Lista de URL de Destino.

Fonte: Pulse CIO List
source_list_pulse boolean

Indica se o pulse.cio.gov Snapshot forneceu essa URL para a Lista de URLs de Destino.

URL de destino
target_url string

O URL com o qual o mecanismo de varredura inicia a verificação.

Teste de URL de destino 404
target_url_404_test boolean

Testa se a URL de destino lida corretamente com 404s chamando um nome de caminho baseado em UUID.

Proprietário da agência de URL de destino
target_url_agency_owner string

A agência proprietária do URL de destino.

URL de destino Ramo governamental
target_url_branch string

O ramo do governo ao qual a URL está associada.

Proprietário do Bureau de URL de Destino
target_url_bureau_owner string

O bureau que possui o URL de destino.

Domínio de URL de destino
target_url_domain string

O domínio base (nome de domínio + domínio de nível superior) do URL de destino.

Redirecionamentos de URL de destino
target_url_redirects boolean

Indica se a URL de destino redireciona.

Contagem de serviços de terceiros
third_party_service_count number

O número de serviços de terceiros encontrados.

Domínios de serviço de terceiros
third_party_service_domains array of string

Uma lista de serviços de terceiros que fazem chamadas de saída a partir do URL final. Um terceiro é definido como não correspondendo ao nome do host da URL.

Contagem de USWDS
uswds_count number

O total de todas as heurísticas de probabilidade USWDS em uma soma.

USWDS Favicon
uswds_favicon number

A presença do favicon USWDS US Flag no código-fonte HTML. A presença adiciona 20 pontos à heurística de probabilidade do USWDS.

USWDS Favicon em CSS
uswds_favicon_in_css number

A presença do favicon USWDS US Flag na fonte CSS. A presença adiciona 20 pontos à heurística de probabilidade do USWDS.

CSS em linha USWDS
uswds_inline_css number

O número de ocorrências de classes .usa- CSS no código-fonte HTML embutido.

USWDS Public Sans Fonte
uswds_publicsans_font number

A presença da fonte Public Sans na fonte CSS. A presença adiciona 20 pontos à heurística de probabilidade do USWDS.

Versão semântica do USWDS
uswds_semantic_version string

A cadeia de caracteres de versão semântica do USWDS.

Fonte USWDS Sans Font
uswds_source_sans_font number

A presença da fonte Source Sans na fonte CSS. A presença adiciona 5 pontos à heurística de probabilidade do USWDS.

Ocorrências de cadeia de caracteres do USWDS
uswds_string number

O número de vezes que a cadeia de caracteres uswds ocorre no código-fonte HTML.

String USWDS em CSS
uswds_string_in_css number

O número de ocorrências de uswds na fonte CSS.

Tabelas USWDS
uswds_tables number

Um cálculo do (número de HTML

elementos) * -10.
são um indicador heurístico negativo da presença de USWDS.

Aulas USWDS USA
uswds_usa_classes number

O número de classes CSS encontradas que começam com .usa-.

Versão do USWDS
uswds_version number

A presença da versão USWDS na fonte CSS. A presença adiciona 20 pontos à heurística de probabilidade do USWDS.