Pular para o conteúdo 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.

O catálogo guarda rulesets para que você possa referenciá-los por name@version no /v1/evaluate em vez de enviar o body inline a cada chamada.

​
Endpoints

MétodoPathPropósito
POST/v1/rulesetsCria um novo (name, version).
GET/v1/rulesetsLista rulesets (paginado).
GET/v1/rulesets/{name}Pega a versão mais recente.
GET/v1/rulesets/{name}/{version}Pega uma versão específica.

​
Criar

curl -X POST https://api-attestly.code4source.com/v1/rulesets \
  -H "Authorization: Bearer atk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "br-rural-credit",
    "version": 1,
    "sets":   { },
    "checks": [ ]
  }'
version é um inteiro. Omita-o para a API atribuir o próximo número livre. Pares (name, version) são imutáveis — re-POSTar o mesmo par retorna 409 RULESET_ALREADY_EXISTS.

​
Response

{
  "data": {
    "ruleset": "br-rural-credit",
    "version": 1,
    "body": { },
    "created_at": "2026-05-05T12:00:00Z"
  }
}

​
Listar

GET /v1/rulesets?page=1&page_size=20
GET /v1/rulesets?name=br-rural-credit
Retorna uma listagem de metadados paginada: 
{
  "data": {
    "items": [
      {
        "ruleset": "br-rural-credit",
        "version": 1,
        "created_at": "2026-05-05T12:00:00Z"
      }
    ],
    "pagination": { "page": 1, "page_size": 20, "total_count": 42, "total_pages": 3 }
  }
}

​
Pegar

GET /v1/rulesets/br-rural-credit          # versão mais recente
GET /v1/rulesets/br-rural-credit/1        # versão fixada