Documentação API GreenGate

Integre triagem ambiental automatizada em sua aplicação

Introdução

A API GreenGate permite validar propriedades rurais contra desmatamento, áreas protegidas, embargos ambientais e outras restrições. Nossa API processa geometrias GeoJSON e retorna análises completas em até 2 minutos.

Base URL

https://greengate.up.railway.app/api/v1

Autenticação

Todas as requisições requerem uma API key no header:

x-api-key: gg_live_xxxxxxxxxxxxxxxxx
Como obter uma API key: Entre em contato através do formulário em www.greengate.com.br

Endpoints Principais

POST /validate/quick

Valida uma geometria e retorna análise completa com score de risco.

Request Body:

{
  "type": "Polygon",
  "coordinates": [
    [
      [-54.1234, -12.5678],
      [-54.1244, -12.5678],
      [-54.1244, -12.5688],
      [-54.1234, -12.5688],
      [-54.1234, -12.5678]
    ]
  ]
}

Response:

{
  "property_id": "uuid",
  "risk_score": 25,
  "compliance_status": "compliant",
  "alerts": [],
  "validation_summary": {
    "deforestation_detected": false,
    "protected_areas": false,
    "indigenous_lands": false,
    "environmental_embargoes": false
  }
}

GET /validate/{property_id}/report

Gera relatório PDF completo com mapa e estatísticas.

Response:

Retorna arquivo PDF para download.

GET /health/detailed

Verifica status do sistema e datasets disponíveis.

Response:

{
  "status": "healthy",
  "datasets": {
    "municipalities": 5570,
    "protected_areas": 235762,
    "deforestation_alerts": "updated"
  }
}

Camadas de Dados

A API GreenGate analisa 7 camadas de dados oficiais:

Camada Fonte Descrição
Desmatamento INPE/PRODES Alertas de desmatamento detectados por satélite
Áreas Protegidas MMA/CNUC Unidades de Conservação federais e estaduais
Terras Indígenas FUNAI Terras indígenas demarcadas e em processo
Embargos Ambientais IBAMA Áreas com embargo ambiental ativo
Assentamentos INCRA Projetos de assentamento da reforma agrária
Quilombolas INCRA Territórios quilombolas certificados
CAR SICAR Cadastro Ambiental Rural (quando disponível)

Rate Limits

Os limites de requisição dependem do seu plano:

Plano Requisições/Mês Rate Limit
Free 1 1 req/min
Professional 100 10 req/min
Enterprise Ilimitado 100 req/min

Códigos de Erro

Código Descrição
400 Geometria inválida ou parâmetros incorretos
401 API key ausente ou inválida
403 API key revogada ou limite excedido
429 Rate limit excedido
500 Erro interno do servidor

Suporte

Para dúvidas, suporte técnico ou solicitar acesso à API, entre em contato:

← Voltar para Home