SAT — Sistema de Acompanhamento de Talhão

Domínio responsável pela ingestão de arquivos Shapefile (.zip) com dados geoespaciais de talhões para análise de imagens de satélite e índices vegetativos (NDVI).

Endpoint

POST /v1/integrations/{partnerId}/sat

Content-Type: multipart/form-data

Autenticação: Authorization: Bearer {token} com role sat.write

Parâmetros (multipart/form-data)

Campo	Tipo	Obrigatório	Descrição
`file`	`file (binary)`	✅	Arquivo ZIP contendo o Shapefile
`usinaId`	`string`	✅	ID da usina para identificação do arquivo

Estrutura do arquivo ZIP

O ZIP deve conter obrigatoriamente todos os arquivos do Shapefile:

Extensão	Descrição
`.shp`	Geometrias
`.shx`	Índice das geometrias
`.dbf`	Atributos dos registros
`.prj`	Sistema de referência de coordenadas
`.cpg`	Codificação de caracteres

Arquivos obrigatórios

O upload será rejeitado se qualquer um dos 5 arquivos estiver ausente no ZIP.

Exemplo curl

curl -X POST \
  "https://api.ctc.com.br/v1/integrations/{partnerId}/sat" \
  -H "Authorization: Bearer {access_token}" \
  -F "file=@talhoes_usina1.zip" \
  -F "usinaId=1"

Resposta

201 — Sucesso400 — Arquivo inválido

{
  "message": "SAT data ingested successfully",
  "blobPath": "raw/hub/sat/1/2025-03-15/shapefile_1_20250315143022100.zip"
}

{
  "code": "VALIDATION_ERROR",
  "message": "Missing required shapefile components: .prj"
}

Referência OpenAPI

src: ../schemas/sat.json