Documentation : Gestion des données

Préambule

L'API Pertinence va effectuer des requêtes sur un modèle de données de type "Index / Document / Champ".

Index

Un index est l'équivalent d'une table dans une base de données relationnelle (SQL).

Document

Un document est l'équivalent d'une ligne dans une table (SQL).

Champ

Un champ est l'équivalent d'une colonne (SQL).

Indexation

L'API Pertinence effectue une recherche sur des données indexées au préalable dans le Cloud Pertinence. Il est donc nécessaire que vos données soient synchronisées dans un index Pertinence.
Deux méthodes sont proposées actuellement.

Consommation d'un flux par Pertinence

Pertinence peut venir consommer un flux (API, XML, JSON, FTP, etc.) qui existe déjà chez vous. Nous effectuons une synchronisation entre vos données et votre index hébergé chez Pertinence.

Note : cette méthode sera dépréciée début 2021. Elle sera remplacée par une API REST où vous allez pouvoir gérer votre index directement.

API Rest Coming soon

Une API REST est en cours de développement afin que vous puissiez gérer vos données sur un principe CRUD (Create, Read, Update, Delete).

Note : cette méthode sera la méthode pérenne à utiliser.

Champs à indexer

Les champs à indexer sont :
- ceux sur lesquels des requêtes vont être effectuées
- ceux que vous souhaitez en retour de l'API

Une fois l'indexation effectuée, l'équipe Pertinence vous transmettra le nom des champs constituant votre index. Ces noms sont ceux qui devront être utilisés lors d'une requête.

Types de champs

Les types de champs possibles sont :

Type Commentaire
boolean Booléen qui vaut true ou false
double Nombre réel. Exemple : 12.54255
keyword Chaîne alphanumerique courte. Exemple : rouge
text Texte. Exemple : Voiture 3 places à vendre sur Paris possédant [...]
date Date au format UTC (YYYY-MM-DDTHH:mm:ss.sssZ).
Exemples :
2020-06-12T20:05:56.124Z
2019-10-28
2020-01-19T14:01:23
geo_point Point géographique au format WKT avec des coordonnées geographiques en degrés décimaux (longitude / latitude). Exemple : POINT(3.06982 43.2071)
geo_shape Forme géographique au format WKT avec des coordonnées geographiques en degrés décimaux (longitude / latitude).
Exemples :
POLYGON((5.75814 45.88408,5.72427 45.89457,5.70509 45.89703,5.75814 45.88408))
LINESTRING(5.75814 45.88408,5.72427 45.89457,5.70509 45.89703)

Configuration du moteur ►

Contactez-nous

Vous souhaitez implémenter du Matching ou du Scoring sur votre site ou votre application ? Nous sommes à votre écoute pour vous accompagner.
Réponse rapide !