Consommer l’api Odata Datachain

Obtenir la liste des expositions disponibles pour l’utilisateur connecté

Datachain Marketplace met à disposition une api Odata, permettant d’obtenir les métadonnées des expositions (informations identiques à celles présentées dans l’interface MarketPlace). Cette api est accessible sous l’url :
https://VOTRE_URL_MARKETPLACE/dmp-api/odata/Datachain/Expositions
et retourne les informations suivantes sur les expositions.

API - 1. Informations
Clé Description

Title

Nom de l’exposition

ODataUrl

Url Odata

Details

Description de l’exposition

Keywords

Mots clés associés

UpdateDate

Date de dernière mise à jour

Columns

Tableau de description des colonnes

Columns[].alias

Alias de la colonne

Columns[].description

Description

Columns[].Type

Type Odata de la colonne

Columns[].filter

Indique si un filtre peut être appliqué sur cette colonne

Columns[].islist

Indique si c’est une colonne de type liste

À noter : Les mêmes informations se trouvent aussi dans les annotations de l’URL metadata des expositions liées à une même racine :
https://VOTRE_URL_MARKETPLACE/dmp-api/odata/<racine>/?metadata

Obtenir les données d’une exposition

L’api OData respecte la norme OData V4, implémentant un sous-ensemble des opérateurs disponibles. Plus d’informations sur OData V4 : https://www.odata.org/documentation/

Exemple d’une requête vers l’API d’exposition Odata
https://VOTRE_URL_MARKETPLACE/dmp-api/odata/<racine>/<exposition>

Syntaxes et opérateurs de requêtes OData

API - 2. Syntaxes des requêtes
Syntaxe Description Obligatoire ?

http://VOTRE_URL_MARKETPLACE/dmp-api/odata/

URL d’accès de base

OUI

<racine>/<exposition>

Nom du point d’accès attribué lors du paramétrage de l’API

OUI

$select=

Sélectionne les colonnes à renvoyer dans la réponse.
Si cette section n’est pas précisée, l’ensemble des colonnes exposées sont retournées.

$filter=

Filtres en fonction des paramètres de filtres définis
Exemple : filter=nom=beginsWith=A
La syntaxe des filtres se trouve dans le tableau suivant.

$skip=

Indique le nombre de résultats à ignorer
Exemple : $skip=250

$top=

Indique le nombre de lignes par page
Exemple : $top=50

$orderby=

Tri en fonction des paramètres définis
Exemple : $orderby=nom desc
API - 3. Convention / Opérateurs
Opérateur Syntaxe Types acceptés Exemple

Et

and

Autres opérateurs

(nom eq 'DURAND' or prenom eq 'Pierre' )

Ou

or

Autres opérateurs

(nom eq 'DURAND' or nom eq 'DUPONT' )

Négation

not

String, Numérique, Booléen, Date

not(nom in ('DURAND','DUPONT'))

Égal

eq

String, Numérique, Booléen, Date

nom eq 'DURAND'

Différent

ne

String, Numérique, Booléen, Date

nom ne 'DURAND'

Supérieur

gt

Numérique, Date

number gt 10

Supérieur ou égal

ge

Numérique, Date

number ge 10

Inférieur

lt

Numérique, Date

number lt 10

Inférieur ou égal

le

Numérique, Date

number le 10

Dans la liste

in

String, Numérique, Booléen, Date

nom in ('DURAND','DUPONT')

Contient

contains()

String

contains(nom,'DU')

Commence par

startswith()

String

startswith(nom,'DU')

Se termine par

endsWith()

String

endsWith(nom,'DU')

Est null

eq null

Tous

nom eq null

Mapping des types Datachain vers les types Odata.

API - 4. Mapping des types
Type Datachain Type Odata

Booléen / Boolean

Boolean

Décimal / Decimal

Boolean

Entier / Integer

Int32

Grand nombre entier / Big Integer

Int64

Chaîne de caractère / String

String

Date / Date

DateTimeOffset

Date / Date

DateTimeOffset

Liste(Type) / List(Type)

Collection(Type)

Dernière mise à jour le 9 décembre 2025 à 18:26