v1.0 — OpenAPI 3.0

AmministraPro Developer API

REST API documentate per integrare AmministraPro nei tuoi sistemi: sincronizza condomini, registra pagamenti, riceve eventi via webhook, automatizza il flusso di lavoro dello studio.

Quick start Scarica OpenAPI spec

Sicurezza

API Key per-studio

Ogni studio genera le proprie API key dal pannello Impostazioni API. Le key sono salvate solo come hash SHA-256: nessuno (nemmeno noi) le puo recuperare dopo la creazione. Mostrate una sola volta al momento della generazione.

Trasporto TLS 1.3

Tutte le chiamate API passano per HTTPS con TLS 1.3. Niente endpoint plain HTTP. Le credenziali terze (Salt Edge, OpenAPI.it, Aruba, ecc.) sono cifrate AES-256-GCM lato server prima di Firestore.

Webhook firmati HMAC

Gli eventi outgoing arrivano firmati con HMAC-SHA256 nel header X-AmministraPro-Signature. Verifica sempre la firma prima di accettare il payload.

Quick start

Genera una API key da /api-settings
Copia il valore (mostrato una sola volta — salvalo subito)
Aggiungilo all'header Authorization: Bearer ...

# Lista condomini dell'organizzazione
curl https://amministra.pro/api/openapi/invoke \
  -H "Authorization: Bearer ak_live_XXXXXXXXXXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "organizationId": "org-abc123",
    "serviceId": "real_estate",
    "endpointPath": "/real_estate/search/by_address",
    "payload": { "query": "Via Roma 1", "comune": "Milano" }
  }'

Reference API completa

Tutti gli endpoint pubblici

Spec OpenAPI 3.0.3 interattiva. Clicca su un endpoint per espandere parametri ed esempi. "Try it out" per chiamare l'API direttamente da qui (richiede una API key valida).

Caricamento Swagger UI...