# API UptimeScout: disponibilidade regional de serviços para suas aplicações e IA

https://jsonscraper.com/pt/blog/uptimescout-api-regional-monitoring-launch

Author: Michael Johnson

Published: 2026-11-19T15:24:18+00:00

Updated: 2026-11-19T15:24:18+00:00

Lançamos uma API no jsonscraper: REST, MCP e seis SDKs prontos. Consulte dependências externas a partir do país desejado — comece gratuitamente.

![UptimeScout — Monitorização da disponibilidade dos serviços](https://jsonscraper.com/assets/img/uptimescout-launch/cover-v8-pt.webp)

Quando uma plataforma externa para de responder, o problema logo passa a ser seu: a autenticação falha, a integração trava e a fila de chamados de suporte cresce. Além disso, o mesmo serviço pode parecer diferente para usuários em países distintos. Nessa situação, um status geral de «tudo está funcionando» não basta.



Estamos lançando a [API UptimeScout no jsonscraper](https://jsonscraper.com/pt/services/uptimescout-api?region=RU). Ela fornece às suas aplicações e aos assistentes de IA sinais regionais de disponibilidade de serviços externos — com histórico, horário da observação e indicação explícita da atualidade dos dados. REST, MCP e SDKs para seis linguagens já estão disponíveis. Você pode começar com o plano gratuito.

 

## Consulte o serviço a partir do país desejado



Para uma equipe de suporte, a pergunta é simples: o que está acontecendo com o serviço onde o usuário está? O UptimeScout permite selecionar um país, obter um sinal atual e compará-lo com observações de outras regiões.



Por exemplo, você pode verificar o GitHub para a Rússia e a Alemanha e, em seguida, consultar o histórico do período disponível. Isso acrescenta contexto aos seus próprios logs e ajuda a decidir o próximo passo da investigação. Na resposta da API verificada em 19 de novembro de 2026, havia 72 regiões disponíveis. Consulte `available_regions` para ver a cobertura atual: ela pode variar entre serviços.



Cada resposta inclui o horário da observação, `observed_at`, e um indicador de dados desatualizados, `stale`. O idioma da descrição é selecionado independentemente do país: você pode obter observações do Japão com descrições em russo ou inglês. Há suporte a 20 idiomas de descrição.



> Um sinal regional ajuda a detectar um problema. Ele não determina a causa nem confirma uma falha global. Para investigar, compare-o com suas próprias verificações e com o status oficial do provedor; as estatísticas de observações não são uma medição de uptime ou de SLA.

 

## Abra o mapa de observações



Selecione um país ou encontre o serviço desejado. Alterne entre o globo e o mapa para ver diferenças regionais e o horário das observações mais recentes.



[Interactive regional observations](https://jsonscraper.com/services/uptimescout-api#regions). Live observations are separate from the historical examples in this article.



O mapa exibe um instantâneo de dados armazenados, atualizado em segundo plano aproximadamente uma vez por minuto. O horário da observação permanece visível: se não houver dados recentes, o estado não pode ser considerado confirmado.

 

## Do sinal externo a uma ação útil



Adicione o UptimeScout ao processo que sua equipe já utiliza. Em um painel, ele oferece contexto sobre dependências externas. No suporte, ajuda a verificar um relato de um país específico. Na automação, torna-se uma fonte de dados para um relatório ou alerta próprio.



![Ilustração conceitual: observações regionais se combinam em uma resposta estruturada de API](https://jsonscraper.com/assets/img/uptimescout-launch/regions-v2.webp)

Contexto regional para suas integrações. Ilustração conceitual, não são medições reais.



1. 01
   
   **Escolha o contexto**
   
   O serviço desejado e o país do seu público.
2. 02
   
   **Verifique a observação**
   
   Status, horário e atualidade dos dados em uma única resposta.
3. 03
   
   **Use o resultado**
   
   Em um painel, no suporte ou em um assistente de IA.



Para várias dependências, use uma solicitação em lote. Para comparar países, faça uma solicitação separada para cada região. Antes de enviar um alerta preocupante aos usuários, verifique o sinal em fontes adicionais.

 

## Uma API para três tarefas



### Encontrar um serviço



`/v1/services` — pesquisa no catálogo. Comece por aqui para escolher a dependência desejada.



### Entender o cenário atual



`/v1/status` retorna o sinal de um serviço, `/v1/statuses` retorna o de vários de uma vez e `/v1/summary` reúne um resumo.



### Ver as mudanças



`/v1/history` fornece o histórico, `/v1/stats` apresenta estatísticas de observações e `/v1/incidents` mostra sinais recentes de problemas elevados.



Todos os sete métodos também estão disponíveis via MCP: por exemplo, `uptimescout_status` e `uptimescout_history`. Os parâmetros completos estão na [especificação OpenAPI](https://uptimescout.com/openapi.json).

 

## Faça a primeira solicitação em poucos minutos



Escolha o [plano gratuito](https://jsonscraper.com/pt/services/uptimescout-api#pricing), obtenha uma chave de licença pelo Evelode e salve-a no servidor em `UPTIMESCOUT_LICENSE_KEY`. Uma única chave funciona com REST, MCP e todos os SDKs do UptimeScout.



```bash
curl --get 'https://api.uptimescout.com/v1/status' \
  --header "Authorization: Bearer $UPTIMESCOUT_LICENSE_KEY" \
  --data-urlencode 'service=github' \
  --data-urlencode 'region=RU' \
  --data-urlencode 'lang=ru'
```



Se você trabalha com Python, instale o cliente pronto a partir da versão publicada no GitHub:



```bash
python -m pip install "git+https://github.com/jsonscraper/uptimescout-api-python.git@0.1.3"
```



```python
import os
from uptimescout import Client

client = Client(os.environ["UPTIMESCOUT_LICENSE_KEY"], timeout=30)
response = client.status("github", region="RU", lang="ru")
service = response["service"]
print(service["status"], service["observed_at"], service["stale"])
```



Além de [Python](https://github.com/jsonscraper/uptimescout-api-python), há SDKs para [Node.js](https://github.com/jsonscraper/uptimescout-api-node), [PHP](https://github.com/jsonscraper/uptimescout-api-php), [Go](https://github.com/jsonscraper/uptimescout-api-go), [Java](https://github.com/jsonscraper/uptimescout-api-java) e [.NET](https://github.com/jsonscraper/uptimescout-api-dotnet). Cada repositório inclui instruções e exemplos de solicitações.



Ao processar a resposta, diferencie dois campos: o `status` de nível superior descreve a execução da solicitação à API, enquanto `service.status` representa o sinal do serviço selecionado. Ao apresentar o resultado, leve em conta o país, o horário da observação e `stale`.

 

## O que chega na resposta



Abaixo está uma resposta real resumida do UptimeScout para o GitHub na Rússia, obtida em 19 de novembro de 2026. Este é um exemplo da estrutura dos dados, não do status atual do serviço; os campos de licença e consumo de cota foram omitidos.



GET /v1/statusJSON · RU



```json
{
  "status": "ok",
  "region": "RU",
  "service": {
    "id": "github",
    "name": "GitHub",
    "status": "operational",
    "stale": false,
    "observed_at": "2026-11-19T13:46:49.188257Z",
    "signal": "reported_availability",
    "scope": "regional"
  },
  "generated_at": "2026-11-19T13:48:48.782598Z",
  "stale_after_seconds": 600
}
```



**`service.status`**


Sinal do serviço selecionado; aqui — operational.



**`region`**


País da observação, não o idioma da resposta.



**`observed_at`**


Horário da própria observação em UTC.



**`stale`**


Indica se a observação já está desatualizada.



O campo `generated_at` mostra o horário em que a resposta foi gerada. Ele não substitui `observed_at`: os dados podem ser mais antigos do que a própria resposta.

 

## A mesma API em uma conversa com um assistente



Se preferir começar sem escrever código próprio, conecte `https://mcp.uptimescout.com` a um cliente de IA compatível. As [instruções do MCP](https://mcp.uptimescout.com/connect?ui_locales=pt) descrevem a autenticação pelo Evelode ou por chave de licença. Também está disponível o [conector geral do jsonscraper](https://jsonscraper.com/pt/services/uptimescout-api#connect).



> «Verifique o GitHub na Rússia e na Alemanha. Informe o horário da observação e a atualidade dos dados para cada país. Se os sinais forem diferentes, explique o que se sabe e quais verificações devem ser feitas a seguir».



O assistente receberá dados estruturados da API e poderá explicar o resultado no contexto da sua tarefa. As limitações de atualidade e de cobertura regional continuam valendo.

 

## Três maneiras de conectar os mesmos dados



Escolha a interface mais conveniente. REST é adequado para solicitações HTTP diretas, SDK para aplicativos e MCP para assistentes de IA. A região, a atualidade da observação e o significado dos status permanecem iguais em todos os casos.



![UptimeScout](https://jsonscraper.com/assets/img/uptimescout-launch/uptimescout-logo.svg)

**API do UptimeScout**Serviço · país · horário da observação



- **REST**Solicitações HTTP diretas
- **SDK**Cliente pronto para o aplicativo
- **MCP**Ferramentas do assistente de IA

 

## Comece gratuitamente com limites claros



O plano Free inclui **1.000 solicitações bem-sucedidas por período de licença**, até **60 solicitações por minuto**, até **5 serviços em um lote** e histórico de **7 dias**. Você pode experimentar REST, SDK e MCP com uma única licença.



Um lote bem-sucedido dentro do limite do plano consome uma solicitação. Cada página adicional do histórico conta como uma chamada separada. A cota está vinculada ao período da licença e é redefinida na renovação ou na mudança de plano, não no primeiro dia do mês. O histórico contém apenas períodos para os quais observações foram efetivamente coletadas.



Isso é suficiente para conhecer a API e criar um protótipo. Para monitoramento contínuo, ajuste a frequência das solicitações à cota; para cargas maiores, há os planos Starter, Builder, Pro e Scale. As condições atuais estão publicadas na [página de planos](https://jsonscraper.com/pt/services/uptimescout-api#pricing).

 

## Comece com uma dependência



Escolha um serviço importante para seu produto e o país onde está seu público. Consulte o mapa, faça a primeira solicitação e avalie como o contexto regional ajuda sua equipe. Depois, adicione o histórico, outras dependências ou seu próprio assistente de IA.



**[Acesse a API UptimeScout e comece gratuitamente →](https://jsonscraper.com/pt/services/uptimescout-api?region=RU)**
