API e integrazioni

Conformità al Regolamento IA UE come layer

Integra la conformità nei tuoi strumenti esistenti. La nostra API classifica i sistemi AI, genera report e applica gate — senza mai uscire dal tuo flusso di lavoro.

Ottieni la chiave API

REQUEST CONTRACTv1

BASE URL: api.azcomply.eu/v1
AUTHENTICATION: X-API-Key
CLASSIFICATION: JSON response
WORKPAPERS: Async jobs

Avvio rapido

Ottieni la tua chiave API

Genera una chiave dalle impostazioni della tua dashboard

Classifica il tuo primo sistema

Invia la descrizione del sistema a /v1/classify e ricevi una decisione JSON strutturata.

Proteggi la tua pipeline CI/CD

Usa gate_pass per bloccare i deployment non conformi

bash

curl https://api.azcomply.eu/v1/classify \
  -X POST \
  -H "X-API-Key: az_test_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "system_name": "TalentRank",
    "description": "AI scores and ranks job applicants before recruiter review.",
    "jurisdictions": ["BE", "NL"],
    "component_mode": "always"
  }'

Riferimento API

POST/v1/classify

Classificazione deterministica EU AI Act da una descrizione testuale

Richiesta

json

{
  "description": "string — AI system description",
  "system_name": "string — optional display name",
  "jurisdictions": ["BE", "NL"] // optional ISO-2 codes
}

Risposta

json

{
  "risk_code": "PROHIBITED | HIGH_RISK | GPAI | GPAI_SYSTEMIC | LIMITED_RISK | MINIMAL_RISK",
  "verdict": {
    "classification": "HIGH",
    "obligations_count": 12
  },
  "gate_pass": false,
  "ci_status": "pass | warn | block"
}

ci_status values

passMINIMAL / LIMITED_RISK

warnGPAI

blockPROHIBITED / HIGH_RISK / GPAI_SYSTEMIC

Snippet di codice

python

import requests

response = requests.post(
    "https://api.azcomply.eu/v1/classify",
    headers={"X-API-Key": "az_test_your_key"},
    json={
        "system_name": "TalentRank",
        "description": "AI scores and ranks job applicants before recruiter review.",
        "jurisdictions": ["BE", "NL"],
        "component_mode": "always",
    },
)
result = response.json()
print(f"Risk: {result['risk_code']}, CI Status: {result['ci_status']}")
if result["ci_status"] == "block":
    raise SystemExit("Deployment gate blocked")

Riferimento campi di risposta

Campo	Tipo	Valori	Descrizione
`ci_status`	`string`	`"pass" \| "warn" \| "block"`	Stato integrazione CI/CD — pass, warn o block
`gate_pass`	`boolean`	`true / false`	Risultato del gate. false indica che la risposta API blocca il deployment e deve essere revisionata.
`risk_level`	`string`	`PROHIBITED, HIGH_RISK, GPAI, GPAI_SYSTEMIC, LIMITED_RISK, MINIMAL_RISK`	Classificazione del rischio EU AI Act
`operator_role`	`string`	`PROVIDER, DEPLOYER, IMPORTER, DISTRIBUTOR`	Il tuo ruolo secondo l'Articolo 3
`readiness_score`	`number`	`0–100`	Punteggio di prontezza conformità 0-100

Provalo

Chiave API

Usa chiave sandbox se vuota — memorizzata in localStorage

Descrizione del sistema

Output

$ Inserisci una descrizione e clicca Classifica

Pronto per l'integrazione?

Genera chiavi API di produzione con accesso completo al motore di classificazione e agli endpoint di monitoraggio

Ottieni la tua chiave API

Le chiavi sandbox (az_test_*) restituiscono risposte identiche per il testing