Integrações · Desenvolvedores
API de NDVI e cenas de satélite para desenvolvedores
Precisa receber cenas de satélite (Sentinel-2 e Landsat) e mapas de vigor vegetal no seu sistema? A API de monitoramento agrícola do ndvi.app entrega NDVI processado por talhão — sem montar pipeline de satélite do zero. Crie uma conta, gere uma chave no perfil e integre via REST.
Por que uma API de cenas e NDVI?
Dados de satélite existem em catálogos públicos. O trabalho pesado é outro: recortar cada talhão, filtrar nuvens dentro do perímetro, calcular NDVI, gerar tiles e manter o processamento a cada passagem. Times de produto agrícola costumam gastar meses nisso — e ainda precisam de UX de mapa, comparação de datas e alertas.
Uma API de NDVI inverte o problema: você envia (ou referencia) o contorno do talhão e recebe cenas prontas, estatísticas e mapas — para embutir no ERP, no app de campo ou no dashboard interno.
O que a API entrega
O núcleo de valor para desenvolvedores: dados de monitoramento prontos para regra de negócio e UI — o mesmo pipeline de cenas e NDVI da interface web.
Catálogo de cenas
Passagens de satélite (Sentinel-2 e Landsat) associadas ao perímetro do talhão, com data, cobertura de nuvem e paginação. O status de processamento fica null até você disparar o process.
Mapas RGB e NDVI
Após POST .../process e READY: imagens prontas para overlay no mapa — vigor vegetal e cor verdadeira no mesmo contorno.
Estatísticas de vigor
Média, mediana, distribuição e área com vigor baixo — números prontos para regra de negócio no endpoint NDVI.
Processamento sob demanda
Na API REST, o cliente lista o catálogo, chama POST .../process na cena desejada e consulta GET .../ndvi até READY.
Para quem faz sentido
Se o usuário final já vive no seu produto, a API evita um segundo login e um fluxo paralelo de monitoramento.
Agritechs e apps de campo
Mostre vigor vegetal no app que o produtor já usa — sem forçar login em outra ferramenta.
ERPs e softwares de gestão
Sincronize NDVI e datas de passagem com o cadastro de talhões e safras do ERP.
Cooperativas e consultorias
Centralize monitoramento de vários associados e priorize visitas com dados atualizados.
Dashboards internos
Alimente BI ou painéis próprios com séries de NDVI e cobertura de nuvem por talhão.
STAC público vs API de monitoramento
Catálogos STAC (como o Planetary Computer) listam cenas Sentinel-2. Isso resolve a descoberta de imagens — não o produto agrícola. Ainda faltam: máscara de nuvem no talhão, NDVI confiável, comparação entre datas, tiles estáveis e um contrato HTTP que o seu backend consiga consumir sem reprocessar bandas.
Use STAC quando o time for construir o pipeline inteiro. Use uma API de NDVI quando o objetivo for entregar valor de monitoramento no produto — e não virar time de sensoriamento remoto.
Endpoints `/api/v1`
Todas as rotas exigem Authorization: Bearer ndvi_live_.... Slugs identificam propriedades e talhões; cenas usam o sceneId do catálogo STAC. Visão resumida abaixo — contrato completo (PATCH/DELETE, ciclo process→NDVI, erros) em /docs/api.
Propriedades
- GET
/api/v1/propertiesListar propriedades acessíveis - POST
/api/v1/propertiesCriar propriedade - GET
/api/v1/properties/:propertySlugDetalhe + talhões
Talhões
- GET
/api/v1/properties/:propertySlug/fieldsListar talhões - POST
/api/v1/properties/:propertySlug/fieldsCriar talhão (GeoJSON) - GET
/api/v1/properties/:propertySlug/fields/:fieldSlugDetalhe do talhão
Cenas e NDVI
- GET
/api/v1/properties/:propertySlug/fields/:fieldSlug/scenesCatálogo paginado de cenas - POST
/api/v1/properties/:propertySlug/fields/:fieldSlug/scenes/:sceneId/processDisparar processamento - GET
/api/v1/scenes/:sceneId/ndvi?propertySlug=...&fieldSlug=...Estatísticas + URLs quando READY (`propertySlug` e `fieldSlug` obrigatórios na query)
Como começar
O acesso é self-service: crie conta, gere chave no perfil e chame a API REST. Os limites de hectares seguem o plano da conta — os mesmos da interface web.
- Crie uma conta no ndvi.app.
- No perfil, gere uma chave de API.
- Chame
/api/v1comAuthorization: Bearer ... - Siga o ciclo documentado em /docs/api: propriedade → talhão → cenas →
process→ NDVI. - Limites de hectares seguem o plano da conta.
Perguntas frequentes sobre API de NDVI
O ndvi.app oferece API pública de NDVI?
Sim. Qualquer usuário com conta pode gerar chaves de API no perfil e chamar `/api/v1` com `Authorization: Bearer ...`. Você integra cenas de satélite e NDVI por talhão no seu produto — sem fila de contato comercial. Detalhes do contrato HTTP estão em /docs/api.
Que dados uma API de cenas e NDVI costuma entregar?
Metadados da passagem (data, satélite, cobertura de nuvem), estatísticas de NDVI (média, mediana, área com vigor baixo) e URLs de mapas RGB/NDVI quando a cena estiver READY. O status de processamento só existe depois que você dispara POST .../process — no catálogo, cenas ainda não processadas vêm com status null.
Posso baixar Sentinel-2 direto do Planetary Computer em vez de usar uma API?
Sim — o catálogo STAC é público. Na prática, você ainda precisa recortar o talhão, filtrar nuvens dentro do perímetro, calcular NDVI, gerar tiles e manter o pipeline. Uma API de monitoramento agrícola encapsula esse trabalho e entrega o resultado pronto para o seu sistema.
Serve para ERP agrícola ou app de cooperativa?
Sim. Casos típicos incluem embutir mapas de vigor no painel do produtor, sincronizar alertas de queda de NDVI com ordens de visita, e alimentar relatórios de safra sem o usuário sair do sistema que já usa.
Qual a diferença entre a interface do ndvi.app e a API?
A interface web é para quem cadastra talhões e analisa no navegador. A API é para quem já tem produto, ERP ou fluxo próprio e quer receber cenas e NDVI no backend — sem redesenhar o monitoramento do zero. Na API, o cliente chama POST .../process e consulta GET .../ndvi até READY.
Como começo a usar a API?
Crie uma conta, abra o perfil e gere uma chave de API. Use o header `Authorization: Bearer ndvi_live_...` nas requisições a `/api/v1`. Os limites de hectares seguem o plano da sua conta — os mesmos da interface web. Guia completo: /docs/api.
Quer integrar cenas e NDVI no seu produto?
Crie conta, gere uma chave no perfil e comece a chamar /api/v1 hoje.