Contenuto.

Web services

Si tratta di un insieme di servizi gratuiti che consentono di utilizzare i dati degli eventi segnalati a Manifestazioni.com, anche nel proprio sito web. Attualmente sono disponibili tre modalità di accesso a tali dati, che si ritiene possano soddisfare le varie possibilità di scripting degli utenti.

Va da sè che, in virtù di quanto specificato in questa pagina, Manifestazioni.com non può fornire un supporto tecnico per l'implementazione di detti servizi nei siti web dei richiedenti, anche perchè trattasi di un extra che non prevede alcun costo.

In ogni caso è necessario che l'utente interessato ai web services si sia registrato in questo sito ed abbia ottenuto l'apposito codice da 32 caratteri (di seguito "xxxx").

Metodo 1: utilizzo di un frame o iframe

È la modalità prevista per l'utente che ha la sola possibilità di utilizzare nel proprio sito pagine (X)HTML e non ha a disposizione nessun linguaggio di scripting. Con questo metodo può comunque utilizzare il motore di ricerca di Manifestazioni.com (per le proprie segnalazioni) creando un frame o un iframe.

Esempio:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="it" xml:lang="it-IT" xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-15" />
<title>Sito dell'utente</title>
</head>
<body>
...
<iframe src="http://www.manifestazioni.com/ws/avanzata.php?utente=xxxx"></iframe>
...
</body>
</html>

Più in dettaglio, è possibile inserire sia il modulo per la ricerca semplice e sia quello per la ricerca avanzata, utilizzando i seguenti URL:

http://www.manifestazioni.com/ws/semplice.php: Ricerca semplice.
http://www.manifestazioni.com/ws/avanzata.php: Ricerca avanzata.

Si dovrà comunque trasmettere in GET il parametro utente relativo al proprio codice utente, come da esempio precedente.

Inoltre si può trasmettere il parametro stile con l'URL completo di un foglio di stile CSS per personalizzare l'aspetto delle pagine web inserite nel proprio sito. Esempio: http://www.manifestazioni.com/ws/semplice.php?utente=xxxx&stile=http://example.com/stile-manifest.css

Metodo 2: inserimento del codice generato da Manifestazioni.com nelle proprie pagine

Se l'utente può utilizzare un linguaggio di scripting server side (es. PHP), può inserire direttamente il codice generato da Manifestazioni.com all'interno delle proprie pagine (X)HTML.

Gli URL a disposizione sono i seguenti:

http://www.manifestazioni.com/ws/semplice.php: Ricerca semplice (form e risultati).
http://www.manifestazioni.com/ws/avanzata.php: Ricerca avanzata (form e risultati).
http://www.manifestazioni.com/ws/manifestazione.php: Scheda della manifestazione.

I parametri da trasmettere, sempre in GET, sono i seguenti:

utente: Include il codice da 32 caratteri assegnato all'utente ed è obbligatorio.
inline: Indica che il codice generato non deve comprendere l'intestazione XHTML, ma solo la parte racchiusa nel body, affinchè possa essere inserito correttamente in una pagina già esistente. Il parametro è obbligatorio e deve assumere un valore qualsiasi, diverso da 0 o da spazi. Il codice generato è sempre XHTML 1.0 Strict in codifica ISO-8859-15.
ricerca: URL della pagina di ricerca, necessario per generare correttamente i link. È obbligatorio nelle pagine di ricerca, ma non va usato nella pagina relativa alla scheda-evento.
scheda: URL della pagina relativa alla scheda-evento, necessario per generare correttamente i link. È obbligatorio nelle pagine di ricerca, ma non va usato nella pagina pertinente la scheda-evento.

Oltre a tali dati, lo script dell'utente dovrà inviare tutti i parametri GET ricevuti, affinchè possano essere eseguite correttamente sia la ricerca e sia la visualizzazione delle informazioni sulla manifestazione.

Esempio (in PHP): si supponga che la pagina di ricerca sia all'URL "http://example.com/ricerca.php" e che la pagina relativa alla scheda-evento sia all'URL "http://example.com/scheda.php". In tal caso le due pagine saranno del tipo:

ricerca.php

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html lang="it" xml:lang="it-IT" xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-15" />
<title>Sito dell'utente: ricerca eventi</title>
</head>
<body>
...
<?php
$URL='http://www.manifestazioni.com/ws/avanzata.php?utente=xxxx&inline=1&ricerca='
 .urlencode('http://example.com/ricerca.php').'&scheda='.urlencode('http://example.com/scheda.php').'&'
 .$_SERVER['QUERY_STRING'];
readfile($URL);
?>
...
</body>
</html>

scheda.php

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html lang="it" xml:lang="it-IT" xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-15" />
<title>Sito dell'utente: scheda evento</title>
</head>
<body>
...
<?php
$URL='http://www.manifestazioni.com/ws/manifestazione.php?utente=xxxx&inline=1&'
 .$_SERVER['QUERY_STRING'];
readfile($URL);
?>
...
</body>
</html>

Metodo 3: prelievo dei dati dal server di Manifestazioni.com

Se il sito dell'utente dispone già di un database degli eventi, è possibile tasferire nello stesso archivio i dati delle proprie segnalazioni inviate a Manifestazioni.com, in formato CSV o XML.

Il servizio è attivabile attraverso l'URL http://www.manifestazioni.com/ws/download.php, comunicando in GET gli stessi parametri disponibili dal form di ricerca avanzata di Manifestazioni.com, più quelli relativi all'utente e al formato dei dati. I principali parametri sono pertanto i seguenti: