UZEmarkets · DevPartner

El puente técnico para los socios de datos de UZEmarkets

UZEmarkets no puede depender de que las API de los socios estén siempre en línea. Este portal es la vía estandarizada para que nuestros socios de datos — ADV Americas, BDCS y Effatha — envíen datos espaciales, de suelo, de feedlots y agrotécnicos al pipeline A/D/R de UZEmarkets, y la referencia pública de cómo esos datos se validan, se almacenan y se consumen.

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

Cómo funciona

Estado del socio

Todo socio está NO VERIFICADO hasta que se firma un acuerdo y se revisa su API. Los snapshots se almacenan como datos declarados por el socio, con estado de proveedor NO VERIFICADO; un snapshot nunca activa por sí solo financiación, tratamiento ni ejecución de subastas.

La Promesa de la Marca

Somos la Capa de la Verdad. No tomamos a sus clientes, no intermediamos sus negocios y no damos asesoría legal ni fiscal. Le damos a usted — el corredor, el abogado, el contador — la verdad financiera verificada y específica de cada microrregión. Pero que no haya error: somos una casa de subastas de RWA. Si su cliente quiere liquidar un activo mediante una subasta de ofertas selladas, aceptaremos esa publicación. Asesores, atención. Sus clientes les pertenecen para el consejo; sus activos pertenecen al mercado para la ejecución.

API de ingesta

Endpoint: POST /api/v1/partners/ingest

Autenticación: Authorization: Bearer <clave de API>. La clave identifica al socio; un payload cuyo partner_id no coincida con el socio de la clave es rechazado.

Respuestas

Esquemas de los socios

Un esquema por socio, versionado junto con este portal. Los payloads que no validan son rechazados — nada se corrige en silencio.

{
  "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..."
  }
}

Flujo de integración

Generador de Payload

Complete sus valores y el generador produce el payload JSON exacto de ADV Americas que nuestro esquema espera. Cópielo y envíelo por POST al 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"
  }
}

Asistente de Integración GIRA

Pegue un payload que falló la validación. GIRA aplica las mismas verificaciones deterministas del endpoint de depuración de la API (POST /api/v1/agents/gira/debug): enumera cada error con su campo, corrige lo que puede corregirse — números enviados como texto, un zarc_risk_score mal ubicado, claves que el esquema no define — y devuelve el JSON corregido.

Documentación Interactiva de la API

La especificación OpenAPI completa, explorable en el navegador. Úsela para inspeccionar cada endpoint, campo y formato de respuesta antes de escribir código.

Abrir la documentación interactiva de la API

Descargas

• Resumen ejecutivo (README)
• Especificación OpenAPI
• Diagrama — flujo de ingesta del socio
• Diagrama — orquestación interna

¿Necesitas una clave de API?

Las claves se emiten por socio, tras revisión. Solicita una al equipo de desarrollo:

Solicitar clave de API dev.build@decensat.org