L'API Pertinence va effectuer des requêtes sur un modèle de données de type "Index / Document / Champ".
Un index est l'équivalent d'une table dans une base de données relationnelle (SQL).
Un document est l'équivalent d'une ligne dans une table (SQL).
Un champ est l'équivalent d'une colonne (SQL).
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.
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.
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.
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.
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) |
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 !