Movements


Introduction

With Navigart 3 API, one can have informations about movements. A movement is a location where were (or are) artworks.

Informations about movements

The simplest way to have information about a movement is to make a query with its id : curl http://api.navigart.fr/123/movements/<id> Informations about movements are available in results, which is an array of movmeents. When you queries one movement, the array contains only one movement.

When you queries the API with standard queries (with ou without filters), results contains the movements matching the filters. An example without filters : curl http://api.navigart.fr/123/movements Here is the response :

     {
                "startIndex": 0,
                "totalCount": 104071,
                "filteredCount": 104071,
                "itemsPerPage": 15,
                "aggregations": {...},
                "results": {...}
     }

As said before, results is an array of movements. Here is the description of important fields you should know (please note that informations are given considering .results[indexOfTheMovement] as root. For example, if it's mentionned ._id, you should understand .results[indexOfTheMovement]._id ).

Filters

Filters on movements work like filters on artworks but the available filters are differents. Here is the list of available filters for movements on a publication : curl http://api.navigart.fr/123/movements/ | jq '.aggregations | keys'

The response is :

[
  "active",
  "artworkid",
  "authors",
  "category",
  "collection",
  "exhib_deposit_from",
  "exhibition_type",
  "movement",
  "movement_category",
  "tree_location_all",
  "year"
]

The filter "active" is important because you can filter on actually active movements (which are movements that occur right now) and historical movements (which are movements that are finished and occur in the past).

Also, you can filter movements by author, by artwork, by collection, by category, … For example : curl 'https://api.navigart.fr/123/movements?filters=active:En+cours' curl 'https://api.navigart.fr/123/movements?filters=movement_category:Prêt' curl 'https://api.navigart.fr/123/movements?filters=authors:BURAGLIO+Pierre↹BURAGLIO+Pierre' curl 'https://api.navigart.fr/123/movements?filters=tree_location_all:Allemagne'

Contact us

You may contact us by sending an email to aide@videomuseum.fr