API REST (Representational State Transfer)

Cos'è un'API REST?

Un'API REST (Representational State Transfer) è uno stile architetturale software che definisce un insieme di vincoli per la creazione di servizi web. Utilizza il protocollo HTTP standard e consente a diverse applicazioni di comunicare tra loro in modo semplice e standardizzato.

I principi fondamentali

• Client-server: Il client (la vostra applicazione) invia richieste al server (l'API), che le elabora e restituisce i dati
• Stateless: Ogni richiesta contiene tutte le informazioni necessarie, il server non memorizza il contesto tra una richiesta e l'altra
• Risorse identificate da URL: Ogni dato è accessibile tramite un URL unico (endpoint)
• Metodi HTTP: GET (leggere), POST (creare), PUT (modificare), DELETE (eliminare)

Formato dei dati

Le API REST moderne utilizzano principalmente il formato JSON (JavaScript Object Notation) per scambiare i dati. Questo formato è leggero, leggibile dall'uomo e facilmente interpretabile da qualsiasi linguaggio di programmazione.

API REST e AILabsAudit

AILabsAudit espone un'API REST pubblica completa su https://ailabsaudit.com/api/v1/, per un totale di 119 endpoint (87 in lettura + 32 in scrittura):

• 87 endpoint in lettura che coprono clienti, audit, report, piani d'azione, analytics, tracking, allucinazioni, agenzia, blog, glossario, questionari, checklist GEO, audit pianificati, vetrine GEO. Ideali per integrare i dati AILabsAudit in una dashboard di terze parti, un CRM o un workflow N8N.
• 32 endpoint in scrittura che permettono di creare clienti, avviare audit, generare report PDF white-label, gestire gli agenti, aggiornare i prompt, attivare azioni del piano d'azione.

L'autenticazione avviene tramite una chiave API (X-Api-Key: aila_* oppure Authorization: Bearer), con una quota predefinita di 60 richieste/minuto, header X-RateLimit-Remaining/X-RateLimit-Reset e tutte le risposte in formato JSON paginato.