Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs-attestly.code4source.com/llms.txt

Use this file to discover all available pages before exploring further.

Un source es un dataset curado — típicamente un registro de polígonos o una lista de identificadores de subject — usado como lado derecho de un match. Ejemplos:
  • br:funai:indigenous-territories — registro oficial de tierras indígenas
  • br:ibama:embargoed-areas — áreas embargadas por infracciones ambientales
  • br:icmbio:conservation-units — unidades de conservación federales
  • ofac:sdn — lista OFAC SDN de EE. UU.
  • br:car:rural-properties — Catastro Ambiental Rural

Listando lo que está disponible

GET /v1/sources
Devuelve metadata de cada source que tu Organización puede acceder — nombre, kind, cobertura por país y timestamp del último refresh. Filtrar por kind:
GET /v1/sources?kind=subject_register
Existen tres kinds:
  • leaf — un source espacial regular.
  • group — una colección virtual que se expande a varias leaves; seleccionar un group equivale a consultar todos sus miembros.
  • subject_register — source no-espacial, indexado por identificadores tipados (CNPJ, EIN, OFAC SDN). Lleva una lista supported_schemes.

Actualización

Cada source lleva collected_at_latest — el timestamp del último refresh. Los sources se actualizan en una cadencia apropiada a la fuente upstream. Si una fuente upstream está indisponible al momento de la query, el check afectado se marca como failed y el status del verdict pasa a degraded. La request aún devuelve 2xx con el resultado parcial, para que decidas cómo manejarlo.

Referenciando sources

En un ruleset:
{
  "sets": {
    "protected_overlap": {
      "source": "br:icmbio:conservation-units",
      "join": { "op": "intersects", "target": "$input" }
    }
  }
}
En /v1/intersections y /v1/distance puedes consultar todos los sources a la vez (default) o restringir a uno específico vía reference_areas_source.