API de Status

1. Status em Tempo Real

GET

Retorna o status operacional atualizado de todas as linhas.

https://ccm.artesp.sp.gov.br/metroferroviario/api/status/

Parâmetro	Tipo	Descrição
empresa	integer	ID da empresa (concessionária ou empresa pública)
linha	integer	ID único da linha
artesp_only	boolean	Filtrar apenas fiscalizadas pela ARTESP

{
  "meta": {
    "versao": "1.0.0",
    "timestamp": "2024-01-28T10:30:00-03:00",
    "filtros_aplicados": { ... },
    "total_linhas": 16,
    "total_empresas": 4
  },
  "empresas": [
    {
      "id": 1,
      "nome": "ViaQuatro",
      "fiscalizacao_artesp": true,
      "linhas": [
        {
          "nome": "Linha 4-Amarela",
          "codigo": "4",
          "ativa": true,
          "status": {
            "situacao": "Operação Normal",
            "classificacao": "operacional",
            "operacao_normal": true,
            "atualizado_em": "...",
            "atualizado_ha": "5 minutos"
          },
          "estacoes": { "total": 11, "nomes": [...] }
        }
      ]
    }
  ]
}

2. Ocorrências Históricas

GET

Download do histórico completo de status operacional. Retorna todos os registros do período em uma única resposta (streaming).

https://ccm.artesp.sp.gov.br/metroferroviario/api/ocorrencias/?data_inicio=YYYY-MM-DD&data_fim=YYYY-MM-DD

Informações Importantes:

Período máximo de 365 dias por consulta
Bulk Download: Não utiliza paginação, entrega todos os dados de uma vez em formato JSON.

Parâmetro	Tipo	Descrição
data_inicio	string	Data inicial (YYYY-MM-DD). Default: 1 ano atrás.
data_fim	string	Data final (YYYY-MM-DD). Default: hoje.
empresa	integer	ID da empresa (Opcional)
page	integer	Número da página (default: 1)

{
  "meta": {
    "versao": "1.0.0",
    "total_registros": 15420,
    "pagina_atual": 1,
    "rate_limit": { ... }
  },
  "ocorrencias": [
    {
      "id": 12345,
      "data_hora": "2024-01-15T08:30:00-03:00",
      "linha": { "nome": "Linha 4-Amarela", ... },
      "empresa": { "id": 1, "nome": "ViaQuatro", ... },
      "situacao": "Velocidade reduzida",
      "classificacao": { "tipo": "operacional", ... }
    }
  ],
  "links": { "proxima": "...", "anterior": null }
}

3. Lista de Empresas

GET

Lista todas as empresas operadoras e seus respectivos IDs.

https://ccm.artesp.sp.gov.br/metroferroviario/api/concessionarias/

{
  "meta": {
    "versao": "1.0.0",
    "timestamp": "2024-01-28T10:30:00-03:00",
    "total": 4
  },
  "empresas": [
    {
      "id": 1,
      "nome": "ViaQuatro",
      "fiscalizacao_artesp": true,
      "linhas": [
        {
          "nome": "Linha 4-Amarela",
          "codigo": "4"
        }
      ]
    },
    {
      "id": 2,
      "nome": "CPTM",
      "fiscalizacao_artesp": false,
      "linhas": [...]
    }
  ]
}

Informações Gerais

Versão 1.0.0
Atualização A cada 5 min
Formato JSON (UTF-8)
Rate Limit Até 12 req/hora

Exemplo cURL

curl "https://ccm.artesp.sp.gov.br/metroferroviario/api/status/?artesp_only=true"

Rate Limit Headers

X-RateLimit-Limit Total de requisições permitidas (1)

X-RateLimit-Remaining Requisições restantes na janela

Retry-After Segundos para próxima tentativa

Monitoramento