Lexiper APIs v1
Documentazione centralizzata di tutti gli endpoint API disponibili. Seleziona un endpoint dalla sidebar per visualizzare i dettagli.
API geografiche
GET
Luoghi Sicilia
/api/v1/geo_luoghi_sicilia
Restituisce i luoghi georeferenziati della Sicilia pubblicati su Lexiper. Endpoint pubblico, utilizzato dal Toolkit Mappa per visualizzare i luoghi su cartografia interattiva.
Visualizza dettagli →
Apri nel Toolkit →
GET
Luogo
/api/v1/luogo/{id}
Restituisce un luogo Lexiper per ID. I luoghi pubblicati sono accessibili pubblicamente; le bozze richiedono autenticazione.
Visualizza dettagli →
GET
Luoghi Lexiper — GeoJSON
/api/v1/geo_luoghi_lexiper
Restituisce i luoghi georeferenziati di Lexiper in formato compatibile con il Toolkit Mappa. Endpoint pubblico.
Visualizza dettagli →
API generiche
GET
Collezione
/api/v1/collezione/{id}
Restituisce una collezione con tutti i suoi item. Le collezioni pubblicate (stato=1) sono accessibili pubblicamente. Le bozze richiedono autenticazione.
Visualizza dettagli →
API dedicate
GET
VEV — Lemmario Varianti
/api/v1/vev
Ricerca e recupero di voci lessicali del VEV con supporto a filtri multipli su lemma, varianti, etimi, definizioni, attestazioni e categorie grammaticali.
Visualizza dettagli →
Prova l'endpoint →
API ecosistema
GET
Collegamento — lista
/api/v1/collegamento
Restituisce i collegamenti approvati per una risorsa federata. Endpoint pubblico — restituisce solo i collegamenti con stato=2 (Approvata). La risposta normalizza sempre la prospettiva: restituisce le informazioni sulla risorsa collegata (non quella richiesta).
Visualizza dettagli →
POST
Collegamento — proponi
/api/v1/collegamento_proponi
Propone un nuovo collegamento federato tra due risorse. Il collegamento viene creato con stato=1 (Proposta) e deve essere approvato manualmente dalla piattaforma destinataria tramite la dashboard o l'API collegamento_approva.
Visualizza dettagli →
POST
Collegamento — approva
/api/v1/collegamento_approva/{id}
Approva un collegamento proposto (stato 1→2). Solo la piattaforma destinataria può approvare: quella in posizione B se il proponente è in posizione A, e viceversa.
Visualizza dettagli →
POST
Collegamento — rifiuta
/api/v1/collegamento_rifiuta/{id}
Rifiuta un collegamento proposto (stato 1→3). Stessa logica di autorizzazione di collegamento_approva. È possibile allegare una motivazione.
Visualizza dettagli →
GET
Notifiche
/api/v1/notifiche
Restituisce il conteggio dei collegamenti in attesa di approvazione per la piattaforma autenticata. Progettato per essere integrato nei pannelli di redazione delle piattaforme federate come sistema di notifica leggero.
Visualizza dettagli →
API tecniche
GET
Test Autenticazione
/api/v1/test
Verifica che la chiave API sia valida. Endpoint di diagnostica per testare l'autenticazione.
Visualizza dettagli →
POST
Genera Token Monouso
/api/v1/token_monouso
Genera un token monouso da incorporare in pagine pubbliche. Il token viene consumato alla prima chiamata.
Visualizza dettagli →