ITALIAN WEB GALLERY

Documentazione - API versione 1.3

A cosa servono?

Letteralmente "API" è l'acronimo di Application programming interface e sono una serie di istruzioni che permetto ad un software di comunicare con altri.

La prima versione di queste API vi permette di inserire all'interno dei vostri siti una "Coccarda" con riferimento alla pagina dedicata su ItalianWebGallery.it .

Coccarda di ItalianWebGallery.it

Con la versione 1.3 soppianta i vecchi metodi inserendo uno tutto nuovo.

Attenzione! I vecchi metodi non funzionano con siti pubblicati dall'Agosto 2012 in poi!

Codice JavaScript (Nuova versione)

Richiamando un file JavaScript all'interno delle vostre pagine otterrete automaticamente il link alla pagina dedicata al vostro sito su ItalianWebGallery.it .

Il codice da inserire tra i tag <head>...</head> è il seguente:

<script type="text/javascript"
   src="http://api.italianwebgallery.it/v1/medal.js?c=ID_SITO">
</script>

ID_SITO indica l'identificativo univoco che il sistema assegna ad ogni sito della directory e lo si può trovare facilmente all'interno delle pagine dedicate ai siti (es. www.italianwebgallery.it/sites/URL_SITO.html) sotto al numero di viste nell'area di testo chiamata ID Sito.

Parametri da passare a "medal.js"

Parametri Richiesto Descrizione Default
c Sì ID sito (es. 9228244746_607...) -
sn - Deprecato - valido solo per siti pubblicati entro il 31 Luglio 2012 -
z No z-index 100000
v No Versione API 1
f No Position "fixed"
"0" CSS position : absolute
"1" CSS position : fixed
Potrebbe non funzionare con IE		 0

Dati relativi a "medal.js"

Nome file MIME Dimensioni Compressione
medal.js text/javascript Circa 1200 byte
Circa 500 byte compresso		 gzip

Una volta incorporato, il codice è pienamente funzionante.

Importante!

IL codice Javascript è stato testato con tutti i più recenti browser ed è risultato stabile e veloce. Se dovessi riscontrare dei conflitti con il codice presente nelle tue pagine ti preghiamo di comunicarcelo all'indirizzo info@italianwebgallery.it e ti invitiamo ad utilizzare il codice HTML da incorporare prima della fine del tag "body".

La "Coccarda" è progettata per apparire nell'angolo alto / destro della pagina. Per evitare che venisse inserita ma che rimanesse nascosta da altri blocchi abbiamo impostato il suo "z-index" pari a 100000. Se non dovesse apparire nele tue pagine ti inviiamo a controllare che non ci siano blocchi con z-index maggiore che potrebbero coprirla.

Segnalazioni

Ti ricordiamo che i siti presenti nella nostra galleria sono stati aggiunti per volontà dello sviluppatore e/o del proprietario dei diritti.

Nel caso volessi segnalarci un abuso (per esempio un sito reliazzato da te e sottoposto da altri) ti preghiamo di inviarci una e-mail a info@italianwebgallery.it, ti ricontatteremo prima possibile per chiarire la situazione.

La nostra iniziativa vuole essere un'opportunità per molti di presentare i propri lavori in un contesto "italiano" a tutti gli effetti. Cerchiamo di svolgere quest amissione in buona fede cercando anche di controllare tutti i siti che ci sottoponete e vi chiediamo un minimo di pazienza se dovesse accadere qualche disguido...siamo ragazzi ragionevoli, parlatene con noi e cercheremo di risolvere qualsiasi cosa...

Grazie dello staff di Italian Web Gallery