EmCursoAPI
Chave

Serviço de dados de emergência · Portugal

Cada ocorrência de Portugal.Em JSON, a 30 segundos da fonte.

Ocorrências de proteção civil da ANEPC, avisos e previsão do IPMA, risco e área ardida do ICNF, e o contexto de trânsito no local do incidente. Fontes distintas, uma só interface, a mesma envolvente de resposta em todos os endpoints.

Ver o catálogoEntrar na consola
curl -H "Authorization: Bearer $EMCURSO_KEY" https://api.emcurso.pt/prociv/ocorrencias/todas
37
endpoints documentados
18
distritos cobertos
278
concelhos por código
30s
de atraso, no máximo

Demonstração

Um header. Um GET. O corpo que a sua aplicação recebe.

Escolha um endpoint e execute. A resposta abaixo é a que está documentada para essa rota, campo a campo — o mesmo que a sua aplicação vai ler.

GET/prociv/ocorrencias/todasSimulação
curl -H "Authorization: Bearer $EMCURSO_KEY" "https://api.emcurso.pt/prociv/ocorrencias/todas"

Reprodução da resposta documentada, com tempos indicativos. Uma chamada real exige uma chave emitida.

Casos de uso

Quando o dia pede
mais a quem está de serviço.

O serviço desaparece dentro de trabalho que já existia. Escolha um momento para ver o que muda nele.

Abrir o catálogo

Proveniência

Fontes oficiais

A origem é sempre a autoridade competente. O que fazemos é normalizar o que cada uma publica e, a partir daí, derivar indicadores — a fonte nunca é nossa.

O contexto de trânsito junto ao local do incidente é obtido de um fornecedor comercial de cartografia, e está identificado como tal em cada resposta que o transporta.

Cobertura

Famílias de dados

Abrir no catálogo

Como funciona

Três passos. Uma chave.

Do pedido à primeira resposta sem SDK, sem OAuth e sem sessão. O que muda entre endpoints são os campos, não a forma de os pedir.

Entidade e requerente
Finalidade prevista
Passo 01

Pedir

Dizer quem é e para quê

O formulário pede a entidade, o tipo de requerente e a finalidade prevista. É sobre isso que o pedido é apreciado, e é isso que fixa os limites atribuídos à chave.

Authorization
Bearer
Endpoints autorizados
Limites atribuídos
Passo 02

Autenticar

Uma chave, um header

A chave viaja em Authorization, em formato Bearer, em cada pedido. É nominal, revogável a qualquer momento e pode ser restringida a um subconjunto de endpoints.

  • success
  • data
  • meta
Passo 03

Consumir

A mesma envolvente, em todos

Todas as respostas trazem success, data e meta. Um cliente escrito contra um endpoint lê os restantes sem trabalho adicional, e os headers dizem o estado da cache e o da quota.

Começar o pedido

Esclarecimentos

Perguntas frequentes

Entidades públicas e privadas, órgãos de comunicação social, instituições de investigação e particulares, desde que declarem a finalidade a que os dados se destinam. Não é exigida forma jurídica nem dimensão mínima: o que é apreciado é a finalidade e o volume previsto, não quem a apresenta.

Precisa de dados que não estão publicados?

A base contém mais do que o catálogo expõe. Descreva a finalidade e o campo em falta — se servir mais do que um integrador, é publicado.

Falar connosco