> ## 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.

# Quickstart

> Faça sua primeira verificação de compliance em menos de um minuto.

## 1. Obtenha uma API key

Chaves são emitidas por Organização no momento do contrato.
[Solicite acesso](mailto:contato@code4source.com) se você ainda não
tem uma.

As chaves seguem o formato `atk_live_...`. Use-as como Bearer token
em toda chamada.

## 2. Veja o que sobrepõe um polígono

```bash theme={null}
curl -X POST https://api-attestly.code4source.com/v1/intersections \
  -H "Authorization: Bearer atk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "geometry": {
        "type": "Polygon",
        "coordinates": [[[-60,-3],[-60,-2],[-59,-2],[-59,-3],[-60,-3]]]
      }
    }
  }'
```

A resposta lista as áreas de referência (áreas protegidas, terras
indígenas, áreas embargadas, etc.) que intersectam o polígono — com
área e frações de sobreposição para cada uma.

## 3. Execute um ruleset completo

```bash theme={null}
curl -X POST https://api-attestly.code4source.com/v1/evaluate \
  -H "Authorization: Bearer atk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "geometry": { "type": "Polygon", "coordinates": [...] }
    },
    "ruleset_id": "br-bacen-cmn-5193-credito-rural@1"
  }'
```

A resposta traz:

* `status` — `ok` ou `degraded` (saúde de execução).
* `outcome` — `compliant`, `warning`, `non_compliant` ou
  `degraded` (resultado de compliance).
* `checks[]` com evidências por check.
* `projections[]` com os valores numéricos que o ruleset calculou.

## Próximos passos

<CardGroup cols={2}>
  <Card title="Como funciona" icon="diagram-project" href="/pt-BR/concepts/how-it-works">
    Geometria → sources → checks → verdict.
  </Card>

  <Card title="Escreva seu próprio ruleset" icon="pen" href="/pt-BR/authoring/ruleset-basics">
    Codifique sua política de compliance.
  </Card>
</CardGroup>