Application Programming Interface

It's a very simple REST - API, you only have to do a HTTP-GET request. As a result, you will get a RSS XML stream with a list of items, direct links included (see Example).

Right now, we have the following main functions documented:

Searching for museum records by:
- fulltext
- collection
- collocation
- finding spot
- date of creation
Searching for finding spots by:
- geographic rectangle
Searching for documents by:
- fulltext

Please note, that this list of functions is constantly growing! Contact admin@museicapitolini.net for any updates.

For those interested in our main underlying record schema, we also give you an example record (see Appendix A).

A. Search Functions for Object Records

1. Fulltext

Function: Get list of object records for a specified phrase (fulltext query).

Syntax: http://capitolini.net/records_fulltext?query=[searchphrase]&format=rss

Where searchphrase is a phrase, with a plus sign (+) instead of spaces. The full Unicode range is supported.

Examples:

http://capitolini.net/records_fulltext?query=Giulio+Cesare&format=rss

http://capitolini.net/records_fulltext?query=لا+اله+الا&format=rss

2. Collection

Function: Get list of objects from a specified historic collection.

Syntax: http://capitolini.net/records_collection?collection=[collection]&format=rss

where: collection is a token from a closed list. You might want to check http://capitolini.net/records_collection for an up-to-date list of collections.

Example:

http://capitolini.net/records_collection?collection=Collezione+Albani&format=rss

3. Collocation

Function: Get list of objects stored (now or in the past) in a specified collocation.

Syntax: http://capitolini.net/records_locations?structure=[structure]&substructure=[substructure]&format=rss

Where structure and substructure are taken from a closed list. You might want to check http://capitolini.net/records_locations for an up-to-date list of locations.

Example:

http://capitolini.net/records_locations?structure=Palazzo+de%27Conservatori&substructure=Esedra+del+Marco+Aurelio&format=rss

4. FindingSpot

Function: Get list of object records for a named finding spot.

Syntax: http://capitolini.net/records_finding?region=[region]&city=[city]&place=[place]&format=rss

Where place is a phrase (street, square, building). You might want to check http://capitolini.net/records_finding for specific places; region is, at least for now, always lazio, and city is, also for now, always roma

Example:

http://capitolini.net/records_finding?place=Via+Gesù+e+Maria&region=Lazio&city=Roma&format=rss

5. Date

Function: Get a list of object records for a specified date range.

Syntax: http://capitolini.net/records_creation?lower=[integer]&upper=[integer]&format=rss

Where lower and upper are integers.

Example:

http://capitolini.net/records_creation?lower=-0200&upper=+0100&format=rss

B. Search Function for FindingSpots by Georeference

Function: Get list of finding spots for a geographic rectangle.

Syntax: http://capitolini.net/spots?north=[north]&west=[east]&south=[south]&east=[east]

Where north, west, south, east are, as usual, in decimal degree form ##.###### (e.g. 41.345474).

Example:

http://capitolini.net/spots?north=41.900000&east=12.500000&south=41.700000&west=12.400000

C. Search Function for Text Documents (Books, Articles)

Function: Fulltext search in text documents

Syntax: http://capitolini.net/documents_books?query=[searchphrase]&format=rss

Where searchphrase is a phrase consisting of one or more words, eventually separated by +, or a valid URN.

Examples:

http://capitolini.net/documents_books?query=piazza+pietra&format=rss

http://capitolini.net/documents_books?query=urn:collectio:0001:scu:00762&format=rss

D. Example answer

<?xml version="1.0" encoding="UTF-8"?>

<copyright>Copyright (c) Musei Capitolini</copyright>

<title>"Giulio Cesare" (records)</title>

<description>This feed is dynamically built using an Xquery.</description>

<item>

<title>EM 299334 : inc: Con e Cesare</title>

<description>Palazzo de'Conservatori Sala delle Aquile</description>

<guid>urn:collectio:0001:em:00299</guid>

</item>

<item>

<title>S 753 [ex Inv. 1692, Portico 1] : Statua colossale di Giulio Cesare</title>

<description>Palazzo Senatorio Aula Senatoria</description>

<guid>urn:collectio:0001:scu:00753</guid>

</item>

<item>

<title>S 1228 : Busto moderno di Giulio Cesare</title>

<description>Palazzo de'Conservatori Ripiano III </description>

<guid>urn:collectio:0001:scu:01228</guid>

</item>

<item>

<title>S 2171 : Ritratto di principe della famiglia Giulio-Claudia</title>

<description>Centrale Montemartini Sala Colonne</description>

<guid>urn:collectio:0001:scu:02171</guid></item>

<item>

<title>S 2638 : Ritratto di Giulio Cesare</title>

<description>Centrale Montemartini Sala Colonne</description>

<guid>urn:collectio:0001:scu:02638</guid>

</item>

</channel>

</rss>

E. Terms of use

If you have scientific non-commercial interests, you can use the API without asking for permission. If you want to make a profit with the API, it is commercial therefore you need our explicit authorization. Please contact us under admin@museicapitolini.net.

Please note: An IP-based authorization mechanism will be activated when we see that the service is being abused. In the interest of everyone, play fair!

F. Disclaimer

This service is provided as-is, there is no obligation for correctness of data nor of delivery. It can be disactivated without prior notice.

Appendix A: Object Record Example

Here is an example of an object record. All object calls are URN-encoded as XLinks in the form urn:[namespaceIdentifier]:[member]:[collection]:[object], where:

[namespaceIdentifier] is always collectio,
[member] is 0001 for Musei Capitolini, 0010 Bibliotheca Hertziana, 0002 Skulpturensammlung Dresden;
[collection] is scu|antcom|ce|med|em|col|pro|mob|amb|invstorico|…
[object] is [0-9]5|[0-9]5bis.

The following sample record stands for Inv.Nr. S 9999 (http://capitolini.net/urn?urn=urn:collectio:0001:scu:99999):

<?xml version="1.0" encoding="UTF-8"?>

<record xmlns="http://hyperrecord.net/hrecord/" xmlns:ns="http://hyperrecord.net/hrecord/"

xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:class="http://collectio.org/classifications/"

xmlns:legacy="http://hyperrecord.net/hrecord/legacy/" xlink:href="urn:collectio:0001:scu:99999"

xml:lang="ita">

<class:objectclass authority="collectio:0001" coverage="sculpture">

<class:type>scultura</class:type>

<class:form>a tutto tondo</class:form>

<class:expression>statua</class:expression>

</class:objectclass>

<denomination>Statua colossale di Giulio Cesare</denomination>

</iconography>

<frame>

<begin>

<date/>

</begin>

<owner>Comune di Roma</owner>

<administrator>Musei Capitolini</administrator>

<name>Inventario Sculture</name>

</inventary>

</frame>

</administration>

<frame>

<begin>

</begin>

<class:locationclass authority="collectio:0001" coverage="Rome.Museums">

<class:museum>Musei Capitolini</class:museum>

<class:structure>Palazzo Senatorio</class:structure>

<class:substructure>Aula Senatoria</class:substructure>

</class:locationclass>

</frame>

<frame>

<begin>

<date/>

</begin>

<end>

</end>

<class:locationclass authority="collectio:0001" coverage="Rome.Museums">

<class:museum>Musei Capitolini</class:museum>

<class:structure>Palazzo Senatorio</class:structure>

<class:substructure>Atrio</class:substructure>

</class:locationclass>

</frame>

</location>

<frame>

<begin>

</begin>

<end>

</end>

<notes>Età traianea (98-117 d.C.)</notes>

</frame>

</creation>

<notes>Restaurato Estremità del naso, frammenti sulla fronte e sulla guancia dx, ambedue le

braccia, parte inferiore delle cosce, panneggio dietro il ginocchio dx.</notes>

</aspect>

</aspect>

</aspect>

<class:materialclass authority="collectio:0001" coverage="pietra">

<class:type>Marmo grechetto</class:type>

</class:materialclass>

</techdata>

<frame>

<begin>

</begin>

<end>

</end>

<class:locationclass authority="collectio:0001" coverage="Italy">

<class:region>Lazio</class:region>

<class:city>Roma</class:city>

<class:municipio>Municipio I</class:municipio>

<class:rione>Rione X Campitelli</class:rione>

<class:place>Portico d'Ottavia</class:place>

</class:locationclass>

<notes>La statua è stata trovata, secondo Pietrangli, nel 1745/50 duranti scavi nella

zona del Portico d'Ottavia - apparentemente nello stesso luogo da dove è stata

ricuperato più tardi il <link xlink:href="urn:collectio:0001:scu:02426">fregio con

simboli navali</link>.</notes>

</frame>

</finding>

<frame>

<begin>

</begin>

<end>

</end>

<notes>Interventi di restauro Consorzio Artigiano-Tecnici del restauro, vedi la <link

xlink:href="urn:collectio:0001:doc:restauro:09686">relazione n.o

9686</link>.</notes>

</frame>

<frame>

<begin>

</begin>

<end>

</end>

<notes>Interventi di restauro Silvia Cerio, vedi <link

xlink:href="urn:collectio:0001:doc:restauro:07236">relazione n.o

7236</link>.</notes>

</frame>

</restoration>

<frame>

<begin>

</begin>

<end>

</end>

<class:locationclass authority="collectio:0001" coverage="world capitals">

<class:country>Italy</class:country>

<class:city>Milano</class:city>

</class:locationclass>

<class:exhibitionclass authority="collectio:0001" coverage="world">

<class:exhibition>Ambrogio e Agostino. Le sorgenti dell'Europa</class:exhibition>

</class:exhibitionclass>

</frame>

<frame>

<begin>

</begin>

<end>

</end>

<class:locationclass authority="collectio:0001" coverage="world capitals">

<class:country>United States</class:country>

<class:city>Washington D.C.</class:city>

</class:locationclass>

<class:exhibitionclass authority="collectio:0001" coverage="world">

<class:exhibition>Picturing the Bible</class:exhibition>

</class:exhibitionclass>

</frame>

</exhibition>

<frame>

<begin>

</begin>

<end>

</end>

<notes>Nell'<link xlink:href="urn:collectio:0001:doc:invstorico:1692-12-14">inventario

compilato nel 1729</link>, la statua viene descritta con le segg. frasi:

«Cominciando dall’Entrata del Portone del sopradetto Palazzo. Nell’ Ingresso di esso

à mano dritta sotto il Portico vi è una Nicchia nella quale vi è un Piedestallo di

Marmo con sopra la statua di Giulio Cesare dittatore di marmo bianco». Simile negli

inventari del <link xlink:href="urn:collectio:0001:doc:invstorico:1734">1734</link>

e del <link xlink:href="urn:collectio:0001:doc:invstorico:1747">1747</link>.</notes>

</frame>

<frame>

<begin>

</begin>

<end>

</end>

<notes>Nell'<link xlink:href="urn:collectio:0001:doc:invstorico:1692-12-14">inventario

compilato nel 1729</link>, la statua viene descritta con le segg. frasi:

«Cominciando dall’Entrata del Portone del sopradetto Palazzo. Nell’ Ingresso di esso

à mano dritta sotto il Portico vi è una Nicchia nella quale vi è un Piedestallo di

Marmo con sopra la statua di Giulio Cesare dittatore di marmo bianco».</notes>

</frame>

<frame>

<begin>

</begin>

<end>

</end>

<notes>Nell'<link xlink:href="urn:collectio:0001:doc:invstorico:1692-12-14">inventario

compilato nel 1692</link>, la statua viene descritta con le segg. frasi:

«Nell’Ingresso del Sudetto Palazzo à mano dritta sotto il Portico vi è una nicchia

nella quale vi è un piedestallo di marmo con sopra la statua di marmo di Giulio

Cesare dittatore».</notes>

</frame>

<frame>

<begin>

</begin>

<end>

</end>

<notes>La prima stampa nell'<link

xlink:href="urn:collectio:0002:lib:Ze1145-1700raro:tav72">Antiquarum Statuarum

Urbis Romae Primus et Secundus Liber</link> di Giovanni Battista de Cavalieri

(prima di 1584), tav.72: «C. Iulij Caesaris simulacrum è marmore Romae in

Capitolio»</notes>

</frame>

</observation>

<frame>

<begin>

</begin>

<end>

</end>

<notes>Acquistato nel 1562 dalla collezione di Alessandro Rufini, insieme con la <link

xlink:href="urn:collectio:0001:scu:00748">statua di un condottiere navale

romano</link>.</notes>

</frame>

</acquisition>

<para>La statua colossale di Giulio Cesare … [segue descrizione dettagliata]</para>

<para>Sulla sua base si trova la seg. iscrizione:</para>

</inscription>

<para>Il ritrovamento nella zona del Portico d'Ottavia, probabilmente nello stesso luogo

come anche il <link xlink:href="urn:collectio:0001:scu:02426">fregio con simboli

navali</link>, faceva pensare a un assemblaggio commemorativo, eseguito

probabilmente in epoca augustea<footnote>

<para>F.Coarelli, BullCom 123, 1979, 23ss. Si pensava anche a un rostrum simile a

quello sul Forum: E.Ferenczy - E.Maróti - H.István: Az ókori Róma története

(1992) 129s. - Resti del <link xlink:href="urn:collectio:0001:col:02433"

>rostrum</link> (?) nel Magazzino Sculture.</para>

</footnote>.</para>

<para>L'uso del gentilico<footnote>

<para>Il nome Καισαρίων, con cui il bambino fu chiamato dagli abitanti di

Alessandria, è in realtà il diminutivo, in greco, del nome Καῖσαρ, e andrebbe

tradotto come Cesaretto. Cfr. Luciano Canfora, Giulio Cesare. Il dittatore

democratico, cap. XXIII, Alessandria, p.229.</para>

</footnote> […]</para>

<para>La figura storica di Giulio Cesare esercitava forte influsso anche dopo la morte […]

fino alla fondazione di intere città <footnote>

<para>Come esempio la città di Caesarea Maritima (gr. παράλιος Καισάρεια; arab.

قيسارية; hebr. קיסריה).</para>

</footnote>.</para>

</description>

<entry type="web resource">http://it.wikipedia.org/wiki/Julius_Caesar</entry>

<entry type="print resource">Stuart Jones, Cons., p.1, n.1, tav.I.</entry>

<entry type="print resource">Helbig³, 885.</entry>

</bibliography>

<name>Mario Rossi.</name>

<notes>Prima immissione dati sulla base delle schede cartacee.</notes>

</editorship>

<legacy:data>Negativi: In numero notevole, vedi Archivio fotografico; MC "d" 2237 (dopo il

restauro 1979); col. N. 855, Almari 6041; Anderson 1656, 4909; MC C/1224 - A/5468 -

A/1463 - A/1462; X Rip. C/1517 - C/1518; Arch. Fot. AA.BB.A 814.</legacy:data>

</editing>

</record>

Last edited 2009-11-15 by kewerner