Code - Documentazione API

Riferimento tecnico per integrare i servizi Aidata (billing, stato API e accesso app).

Base URL produzione: https://aidataitalia.it

Autenticazione

Gli endpoint pubblici non richiedono token. Gli endpoint utente/app richiedono sessione login valida.

PUBBLICO /api/health, /api/billing/plans, /api/billing/checkout-session-public
AUTH quote e funzioni operative delle app

Formato richieste

Inviare JSON con header:

Content-Type: application/json

Le risposte errore usano struttura JSON con dettaglio.

Endpoint principali

Metodo	Endpoint	Uso
`GET`	`/api/health`	Controllo stato API
`GET`	`/api/billing/plans`	Elenco piani abbonamento disponibili
`POST`	`/api/billing/checkout-session-public`	Crea checkout Stripe anche senza login (email + piano)

Esempio 1 - Health check

curl -s https://aidataitalia.it/api/health

Risposta attesa: stato servizio attivo.

Esempio 2 - Piani

curl -s https://aidataitalia.it/api/billing/plans

Restituisce array piani (slug, nome, prezzo, periodicita).

Esempio checkout pubblico

curl -X POST https://aidataitalia.it/api/billing/checkout-session-public \
  -H "Content-Type: application/json" \
  -d '{"plan_slug":"starter-monthly","email":"utente@dominio.it"}'

Se la richiesta e valida, la risposta contiene URL/sessione di checkout Stripe.

Errori comuni

HTTP	Caso	Azione consigliata
`400`	Payload mancante o email/piano non valido	Verificare JSON e `plan_slug`
`401`	Sessione non valida (endpoint autenticato)	Eseguire login e riprovare
`429`	Quota free giornaliera superata	Attendere reset giornaliero o attivare abbonamento
`500`	Errore server temporaneo	Riprovare e, se persiste, contattare supporto

Supporto tecnico e sviluppi personalizzati

Per integrazioni su misura, workflow custom e nuove API: info@aidataitalia.it