A major schema enhancement happens for meta values. Multivalued values were stored serialized and are now stored separatly. Two routes are modified : records/metadatas and records/setmetadatas. A route has been added to make it easy to display caption : records/caption.
This enhancement allows to store ressource in multivalued fields like users, geoname entities, Thesaurus entries...
The main consequence is a change in two API routes : records/metadatas and records/setmetadatas, therefore the upgrade of API to version 1.1.
Route records/metadatas was returning results like :
"6272": { //Monovalued field "meta_id": 6272, "meta_structure_id": 2, "name": "Categorie", "value": "paysages" }, "6273": { //Monovalued field "meta_id": 6273, "meta_structure_id": 4, "name": "MotsCles", "value": [ "ciel", "météo", "nuage" ] }Responses in API 1.1 are now like :
"6272": { //Monovalued field value "meta_id": 6272, "meta_structure_id": 2, "name": "Categorie", "value": "paysages" }, "6273": { //Multivalued field value "meta_id": 6273, "meta_structure_id": 4, "name": "MotsCles", "value": "ciel" }, "6274": { //Multivalued field value "meta_id": 6274, "meta_structure_id": 4, "name": "MotsCles", "value": "météo" }, "6275": { //Multivalued field value "meta_id": 6275, "meta_structure_id": 4, "name": "MotsCles", "value": "nuage" }
For developers who were using this route to display caption, we add the route records/caption which is easier in that case. You should use records/metadatas when you’re planning to edit metadatas.
"2": { //Monovalued field value "meta_structure_id": 2, "name": "Categorie", "value": "paysages" }, "4": { //Multivalued field serialized "meta_structure_id": 4, "name": "MotsCles", "value": "ciel ; météo ; nuage" }See also
complete documentation for route records/caption
La route records/setmetadatas was working like this :
// HTTP parameters : metadatas = { //Add a value in a monovalued field { meta_struct_id: 1, meta_id: null, value : [ 'A pretty string' ] }, //Update a value in a multivalued field { meta_struct_id: 3, meta_id: 487, value: [ 'one key word', 'two key word' ] }, //Delete a value { meta_struct_id: 7, meta_id: 489, value: [] } }Now, you must use it like this :
metadatas = { //Add a value in a monovalued field { meta_struct_id: 1, meta_id: "", value : 'A pretty string' }, //Update a value in a multivalued field { meta_struct_id: 3, //champ multivalué meta_id: 487, value: 'one key word' }, //Add a value in a multivalued field { meta_struct_id: 3, //champ multivalué meta_id: "", value: 'second key word' }, //Delete a value in a multivalued field { meta_struct_id: 3, //champ multivalué meta_id: 487, value: "" }, //Add a value in a monovalued field { meta_struct_id: 7, meta_id: 489, value: "" } }