UZEmarkets · DevPartner

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

A UZEmarkets não pode depender de que as APIs dos parceiros estejam sempre disponíveis. Este portal é a forma normalizada de os nossos parceiros de dados — ADV Americas, BDCS e Effatha — enviarem dados espaciais, de solo, de engorda de gado e agrotécnicos para o pipeline A/D/R da UZEmarkets, e a referência pública de como esses dados são validados, guardados e consumidos.

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

Como funciona

Estado do parceiro

Todos os parceiros estão NÃO VERIFICADOS até ser assinado um acordo e a sua API ser revista. Os snapshots são guardados como dados declarados pelo parceiro, com estado de fornecedor NÃO VERIFICADO; um snapshot nunca despoleta, 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 os seus clientes, não intermediamos os seus negócios e não prestamos aconselhamento jurídico ou fiscal. Capacitamos o utilizador — o mediador, o advogado, o contabilista — 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 através de um leilão de licitações seladas, aceitaremos esse anúncio. Consultores, atenção. Os seus clientes pertencem-lhe 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

Esquemas dos parceiros

Um esquema por parceiro, com controlo de versões juntamente com este portal. Os 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-o e envie-o 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 tenha falhado a validação. A GIRA aplica as mesmas verificações determinísticas do endpoint de depuração da API (POST /api/v1/agents/gira/debug): enumera cada erro com o respetivo 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. Utilize-a para inspecionar cada endpoint, campo e formato de resposta antes de escrever código.

Abrir a documentação interativa da API

Transferências

• Resumo executivo (README)
• Especificação OpenAPI
• Diagrama — percurso do parceiro em autosserviço
• Diagrama — arquitetura interna de agentes

Precisa de uma chave de API?

As chaves são emitidas por parceiro, após revisão. Peça uma à equipa de desenvolvimento:

Pedir chave de API dev.build@decensat.org