UZEmarkets · DevPartner

A ponte técnica para os parceiros de dados da UZEmarkets

A UZEmarkets não pode depender da disponibilidade das APIs dos parceiros. Este portal é a forma padronizada para os nossos parceiros de dados — ADV Americas, BDCS e Effatha — enviarem dados espaciais, de solo, de confinamento e agrotécnicos para o pipeline A/D/R da UZEmarkets, e a referência pública de como esses dados são validados, armazenados e consumidos.

Idioma: en · pt-BR · es · pt-PT

Como funciona

Status do parceiro

Todo parceiro é NÃO VERIFICADO até que um acordo seja assinado e sua API seja revisada. Os snapshots são armazenados como dados declarados pelo parceiro, com status de provedor NÃO VERIFICADO; um snapshot nunca aciona, por si só, financiamento, tratamento ou execução de leilão.

A Promessa da Marca

Nós somos a Camada da Verdade. Não tomamos seus clientes, não intermediamos seus negócios e não prestamos consultoria jurídica ou tributária. Capacitamos você — o corretor, o advogado, o contador — com a verdade financeira verificada e específica de cada microrregião. Mas não se engane: somos uma casa de leilões de RWA. Se o seu cliente quiser liquidar um ativo por leilão de lances selados, aceitaremos esse anúncio. Consultores, atenção. Seus clientes pertencem a vocês para aconselhamento; os ativos deles pertencem ao mercado para execução.

API de ingestão

Endpoint: POST /api/v1/partners/ingest

Autenticação: Authorization: Bearer <chave de API>. A chave identifica o parceiro; um payload cujo partner_id não corresponda ao parceiro da chave é rejeitado.

Respostas

Schemas dos parceiros

Um schema por parceiro, versionado junto com este portal. Payloads que não validam são rejeitados — nada é corrigido silenciosamente.

{
  "partner_id": "AGRO_DIGITAL",
  "polygon_id": "BR-MT-36400",
  "geojson_polygon": {
    "type": "Polygon",
    "coordinates": [[[-56.1, -12.5], [-56.0, -12.5], [-56.0, -12.4], [-56.1, -12.4], [-56.1, -12.5]]]
  },
  "soil_profile": {
    "ph_level": 5.8,
    "nitrogen_ppm": 12.4,
    "phosphorus_ppm": 8.2,
    "potassium_ppm": 45.0,
    "organic_matter_pct": 2.1
  },
  "crop_suitability": {
    "crop_type": "CORN_SILAGE",
    "yield_potential_tons_per_ha": 14.5,
    "zarc_risk_score": "LOW"
  },
  "attestation": {
    "provider_timestamp": "2026-11-08T14:00:00Z",
    "cryptographic_hash": "sha256:a1b2c3d4...",
    "satellite_source": "Sentinel-2"
  }
}

{
  "partner_id": "BDCS",
  "polygon_id": "BR-MT-36400",
  "language": "pt-BR",
  "feedlot_context": {
    "cattle_head_count": 1500,
    "feed_type": "CORN_SILAGE",
    "target_slaughter_weight_kg": 550,
    "feed_optimization_index": 0.85
  }
}

{
  "partner_id": "EFFATHA",
  "polygon_id": "BR-MT-36400",
  "language": "pt-BR",
  "agrotechnical_context": {
    "delivery_mechanism": "SATELLITE_FREQUENCY",
    "treatment_protocol_id": "EFFATHA-CORN-01",
    "target_crop": "CORN_SILAGE",
    "activation_date": "2026-11-08T00:00:00Z"
  },
  "attestation": {
    "provider_timestamp": "2026-11-08T14:00:00Z",
    "cryptographic_hash": "sha256:e5f6g7h8..."
  }
}

Fluxo de integração

Gerador de Payload

Preencha os seus valores e o gerador produz o payload JSON exato da ADV Americas que o nosso esquema espera. Copie e envie por POST para o endpoint sandbox.

{
  "partner_id": "AGRO_DIGITAL",
  "polygon_id": "BR-MT-36400",
  "geojson_polygon": {
    "type": "Polygon",
    "coordinates": [
      [
        [
          -56.0728,
          -12.5453
        ],
        [
          -56.01,
          -12.5453
        ],
        [
          -56.01,
          -12.49
        ],
        [
          -56.0728,
          -12.49
        ],
        [
          -56.0728,
          -12.5453
        ]
      ]
    ]
  },
  "soil_profile": {
    "ph_level": 5.8,
    "nitrogen_ppm": 42,
    "phosphorus_ppm": 18,
    "potassium_ppm": 120,
    "organic_matter_pct": 3.4
  },
  "crop_suitability": {
    "crop_type": "soybean",
    "yield_potential_tons_per_ha": 3.6,
    "zarc_risk_score": "LOW"
  },
  "attestation": {
    "provider_timestamp": "2026-11-08T14:32:00Z",
    "cryptographic_hash": "sha256:9f2c…",
    "satellite_source": "Sentinel-2"
  }
}

Assistente de Integração GIRA

Cole um payload que falhou na validação. A GIRA aplica as mesmas verificações determinísticas do endpoint de depuração da API (POST /api/v1/agents/gira/debug): lista cada erro com o seu campo, corrige o que pode ser corrigido — números enviados como texto, um zarc_risk_score mal posicionado, chaves que o esquema não define — e devolve o JSON corrigido.

Documentação Interativa da API

A especificação OpenAPI completa, explorável no navegador. Use-a para inspecionar cada endpoint, campo e formato de resposta antes de escrever código.

Abrir a documentação interativa da API

Downloads

• Resumo executivo (README)
• Especificação OpenAPI
• Diagrama — fluxo de ingestão do parceiro
• Diagrama — orquestração interna

Precisa de uma chave de API?

As chaves são emitidas por parceiro, após revisão. Solicite uma à equipe de desenvolvimento:

Solicitar chave de API dev.build@decensat.org