<](http://www.musambule.com)
API Overview
------
The **Musambule REST API** connects your website or application with the opendata content of the **Agccpf-Paca**, to discover all museums and cultural events.
The **REST API** provides programmatic access to read the **[Musambule](http://www.musambule.com)** open datas and more.
### Documentation
* Read the full [API3.0 Reference](http://docs.musambule.com/3.0)
### Versioning
```
http://api.musambule.com/0.1
...https://api.musambule.com/3.0
```
each api version can be accessed in parallel.
### Hello World
```
curlhttps://api.musambule.com/3.0/museums?prettyprint=true
```
HTTP status codes are used to indicate the success or otherwise of requests. The following status are common:
| **Code** | Description |
| -----------| -------------- |
| **200** | Successful request. Body will contain a JSON hash of response data |
| **400** | Error: details in response body |
### Json structure
The Musambule REST API responses are available in JSON.
#### for error
```
{
"status": "error",
"code": "404"
"message": ...
}
```
* **status** : always "error"
* **code** : the code or id associated with the error
* **message** : an error text message
#### for success
```
{
"status": "success",
"url": "https://api.musambule.com/3.0/museums/near?limit=10&offset=0&latitude=44.090274&longitude=6.23944&distance=0&skin=normal",
"count": 53,
"received": "2014-06-27T04:24:48Z"
"result": ...
}
```
* **status** : always "success"
* **url** : the exact URL with all the params that the API used to return the result
* **result** : the actual result as an array (more than 1) or object (only 1)
* **count** : the number of result(s) can be at least 1 or more (optional)
* **total** : the total number of result(s) when the collection is a part of a bigger collection (use limit and offset) (optional)
### Licences
You may re-use the « Information » made available by the « Producer » under the freedoms and the conditions specified by the licence : [Licence Ouverte / Open Licence](http://wiki.data.gouv.fr/wiki/Licence_Ouverte_/_Open_Licence)
[](http://wiki.data.gouv.fr/wiki/Licence_Ouverte_/_Open_Licence) [](https://www.etalab.gouv.fr)
The **Musambule REST API** re-use too the **[INSEE](https://api.musambule.com/3.0/insee)** datas.
[](http://www.insee.com)
---
Ontology and vocabulary
------
The ontology and the vocabulary of the Musambule datas are based on the Schema.org specifications.
[Schema.org](http://www.schema.org) provides a collection of schemas, i.e., html tags, that webmasters can use to markup their pages in ways recognized by major search providers. Search engines including Bing, Google, Yahoo! and Yandex rely on this markup to improve the display of search results, making it easier for people to find the right web pages.
We use a part of the Schema.org ontology to defines the objects returns in the **Musambule API**.
Depending on the requirements we will complete patterns with other types of ontologies but trying to keep up standards and simplicity.
In this first version of the API we try to use the namespaces :
* **Thing** :https://api.musambule.com/3.0/Thing
* **GeoCoordinates** :https://api.musambule.com/3.0/GeoCoordinates
* **Offer** :https://api.musambule.com/3.0/Offer
* **PostalAddress** :https://api.musambule.com/3.0/PostalAddress
* **Event** :https://api.musambule.com/3.0/Event
* **Place** :https://api.musambule.com/3.0/Place
* **Museum** :https://api.musambule.com/3.0/Museum
**Dublin Core Metadatas**
In all the API objects, when it's possible, we use 3 specific properties from the Dublin Core Metadata schema :
* [created](http://dublincore.org/documents/dcmi-terms/#terms-created)
* [modified](http://dublincore.org/documents/dcmi-terms/#terms-modified)
* [publisher](http://dublincore.org/documents/dcmi-terms/#terms-publisher)
Note : The *Dublin Core Schema* is a small set of vocabulary terms that can be used to describe web resources (video, images, web pages, etc.), as well as physical resources such as books or CDs, and objects like artworks. The full set of Dublin Core metadata terms can be found on the [Dublin Core Metadata Initiative](http://dublincore.org/) (DCMI) website.
______
Contributors
------
[](http://www.musees-mediterranee.org/reseau/)
Reconnue d’intérêt général depuis 2017, **[Musées Méditerranée](http://www.musees-mediterranee.org) : Association pour la Conservation et la Valorisation des collections publiques de France - région Sud Provence-Alpes-Côte d’Azur** fédère et représente l’ensemble des 118 établissements labellisés **« musées de France »** existants en région Sud PACA.
Depuis 2000, l’association, véritable pôle ressources et formation pour les acteurs du patrimoine en **Région Sud Provence-Alpes-Côte d’Azur**, s’est engagée dans un travail collectif destiné à ouvrir les perspectives des professionnels des patrimoines aux enjeux européens qui bousculent l’héritage muséal.
En 2008, la section PACA et la section du **ex-Languedoc-Roussillon** (représentant 58 musées) se rapprochent et élargissent de façon significative les problématiques muséales aux spécificités de la façade méditerranéenne et constituent le Réseau Méditerranée.
[](https://www.ooopener.com)
The [Ooopener](https://www.ooopener.com) dev team creates and develops the **Musambule** REST API and the Musambule application.
]]>