Documentazione · per IT, sviluppatori, partner

Documentazione
scritta bene.

API REST, autenticazione CMS PHP, integrazioni HMAC, architettura e sicurezza. Pensata per chi deve davvero implementare, non per riempire una pagina.

01 - Cosa trovi

Quattro aree.

API REST

Endpoint su /wp-json/medaid/v1/, autenticazione CMS PHP (cookie/nonce o application password), risorse per pazienti, visite e moduli.

Vedi sezione API →

Connessioni HMAC

Scambi firmati HMAC-SHA256 per la federation tra installazioni e per il gateway delle prenotazioni online.

Vedi connessioni HMAC →

Integrazioni

Trasmissione documenti, Sistema Tessera Sanitaria (STS), Google Calendar, gateway Stripe e PayPal, dispositivi medici.

Tutte le integrazioni →

Architettura

Stack tecnologico verificabile: PHP / CMS PHP, MariaDB, hosting su server in Italia e Germania, requisiti di rete.

Vedi architettura →

02 - API REST

Endpoint chiari, sulla tua installazione.

Base URL: https://tuo-dominio.it/wp-json/medaid/v1/. Autenticazione CMS PHP: cookie di sessione + nonce wp_rest, oppure application password.

# Esempio: leggere i pazienti (application password)
curl -u "utente:application_password" \
     -H "Accept: application/json" \
     https://tuo-dominio.it/wp-json/medaid/v1/patients

# Esempio: creare una visita
curl -X POST https://tuo-dominio.it/wp-json/medaid/v1/visits \
     -u "utente:application_password" \
     -H "Content-Type: application/json" \
     -d '{
       "patient_id": 123,
       "type": "control",
       "scheduled_at": "2026-05-01 10:30:00"
     }'

Risorse principali

/patients · anagrafica e gestione pazienti
/visits · agenda, prenotazioni, esiti
/modules · moduli attivi e configurazione
/studio/stats · statistiche dello studio
/system/health · stato di salute della piattaforma

Richiedi documentazione completa degli endpoint

03 - Connessioni HMAC

Federation e prenotazioni online.

Medaid usa scambi firmati HMAC-SHA256 per validare la sorgente nelle integrazioni tra installazioni (federation) e nel gateway delle prenotazioni online sul sito pubblico.

Firma HMAC-SHA256 su payload e header di autenticazione della richiesta
Federation tra piattaforme Medaid (es. collegamento studi / sedi)
Gateway prenotazioni: il sito pubblico inoltra le richieste all’installazione Medaid dello studio
Segreti e chiavi gestiti lato piattaforma, mai esposti nell’interfaccia utente

Per lo schema di firma e gli header attesi, il team tecnico condivide la specifica operativa in fase di integrazione.

04 - Architettura

Stack & infrastruttura.

PHP / CMS PHP · database MariaDB (tabelle dedicate prefissate Medaid)
Applicazione frontend-first su route /app/*, con REST API su /wp-json/medaid/v1/
Hosting su server in Italia e Germania, sempre in Unione Europea, con SSL e backup periodici
Crittografia AES-256-GCM per dati sensibili a livello di form/campo
Monitoraggio salute piattaforma tramite endpoint dedicato e controlli operativi

Requisiti di rete

HTTPS (porta 443) verso l’installazione Medaid del cliente
Per federation e prenotazioni online: comunicazione firmata HMAC tra i nodi coinvolti
Accesso API: autenticazione CMS PHP (sessione+nonce oppure application password)

Documentazione scritta bene.