https://github.com/161io/labodata-api
Fiche produit LaboData - API JSON v1.4
https://github.com/161io/labodata-api
api api-json database json labodata parapharmacie pharmacie
Last synced: about 2 months ago
JSON representation
Fiche produit LaboData - API JSON v1.4
- Host: GitHub
- URL: https://github.com/161io/labodata-api
- Owner: 161io
- Created: 2016-07-11T15:17:26.000Z (over 9 years ago)
- Default Branch: main
- Last Pushed: 2023-10-24T19:16:33.000Z (over 2 years ago)
- Last Synced: 2023-10-24T20:32:15.235Z (over 2 years ago)
- Topics: api, api-json, database, json, labodata, parapharmacie, pharmacie
- Homepage: https://www.labodata.com
- Size: 30.3 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: Readme.md
- Changelog: Changelog.md
Awesome Lists containing this project
README
# LaboData - La fiche de référence
Pour les pharmacies et les parapharmacies en ligne et bien plus encore.
## Documentation de l'API JSON
L'API utilise des requêtes au format **POST** ou **GET**. L'API ne peut être consulté que par une seule adresse IP serveur.
Chaque requête doit utiliser en paramètre l'adresse `email` du compte et la clé privée `secret` fournie sur le site labodata.com
Nous vous déconseillons de faire des appels directement en Javascript (côté client) du fait de la restriction par IP.
### Test de la connexion, contrôle du compte et crédits disponibles
Cette requête permet de tester si la connexion est bien établie et la clé privée est correcte. Vous trouverez la clé privée dans votre zone mon compte sur https://www.labodata.com
Requête *(gratuite)* :
```
https://www.labodata.com/api/v1/account.json?email=YOUR@EMAIL&secret=YOUR_KEY
```
Réponse : Voir le fichier `account.json`
### Lien de connexion automatique au site LaboData.com sans identification
Cette requête délivre un jeton d'identification permettant de se connecter automatiquement au site LaboData.com sans passer par le formulaire d'identification.
Important: Ce jeton est à usage unique et à durée de vie de 10 minutes.
Requête *(gratuite)* :
```
https://www.labodata.com/api/v1/autoconnect.json?email=YOUR@EMAIL&secret=YOUR_KEY
```
Réponse : Voir le fichier `autoconnect.json`
#### Lien de connexion automatique au site LaboData.com sans identification et amenant à la zone de paiement
Cette requête délivre un jeton d'identification permettant de se connecter automatiquement au site LaboData.com sans passer par le formulaire d'identification.
Une fois sur le site LaboData, l'utilisateur arrivera sur l'interface de paiement **Approvisionner**.
En fin de paiement, si le paramètre `redirect` est précisé, l'utilisateur sera redirigé vers cette page ( pensez à utiliser une fonction du type http://php.net/urlencode ).
```
https://www.labodata.com/api/v1/autopay.json?email=YOUR@EMAIL&secret=YOUR_KEY&redirect=https%3A%2F%2Fwww.apotekisto.fr%2Fadministration%3F...
```
Réponse : Voir le fichier `autopay.json`
### Liste des marques disponibles
Cette requête vous permet de lister les marques disponibles dans LaboData et le nombre de fiches produits disponibles.
Ajouter le paramètre `all=1` pour voir les marques vides.
Requête *(gratuite)* :
```
https://www.labodata.com/api/v1/category/brand.json?email=YOUR@EMAIL&secret=YOUR_KEY
```
Réponse : Voir le fichier `category/brand.json`
### Liste des critères disponibles
Cette requête vous permet d'obtenir l'intégralité de la nomenclature des fiches produits.
Ajouter le paramètre `all=1` pour voir les critères vides.
Requête *(gratuite)* :
```
https://www.labodata.com/api/v1/category/criteria.json?email=YOUR@EMAIL&secret=YOUR_KEY
```
Réponse : Voir le fichier `category/criteria.json`
### Liste des arborescences disponibles
Cette requête vous permet d'obtenir l'intégralité des arborescences des fiches produits.
Ajouter le paramètre `all=1` pour voir les arborescences vides.
Requête *(gratuite)* :
```
https://www.labodata.com/api/v1/category/tree.json?email=YOUR@EMAIL&secret=YOUR_KEY
```
Réponse : Voir le fichier `category/tree.json`
### Rechercher une ou plusieurs fiches produits
Cette requête vous permet de rechercher dans la base de données LaboData. Vous pouvez rechercher par code(s) cip, par marque, ou par texte libre.
Chaque résultat retournera au maximum **50** éléments. Pour les résultats suivants, vous devez utiliser le paramètre `page` (avec un maximum de 50 pages).
*A noter : les liens images ont une durée de vie d'une heure maximum.*
Requête *(gratuite)* :
```
https://www.labodata.com/api/v1/product/search.json?email=YOUR@EMAIL&secret=YOUR_KEY&code=CIP1,CIP2,CIP3...
https://www.labodata.com/api/v1/product/search.json?email=YOUR@EMAIL&secret=YOUR_KEY&brand=BRAND_NAME
https://www.labodata.com/api/v1/product/search.json?email=YOUR@EMAIL&secret=YOUR_KEY&q=TEXTE_LIBRE
https://www.labodata.com/api/v1/product/search.json?email=YOUR@EMAIL&secret=YOUR_KEY&type=normal
https://www.labodata.com/api/v1/product/search.json?email=YOUR@EMAIL&secret=YOUR_KEY&type=without_prescription
https://www.labodata.com/api/v1/product/search.json?email=YOUR@EMAIL&secret=YOUR_KEY&type=veterinary
https://www.labodata.com/api/v1/product/search.json?email=YOUR@EMAIL&secret=YOUR_KEY& ... &page=1
https://www.labodata.com/api/v1/product/search.json?email=YOUR@EMAIL&secret=YOUR_KEY& ... &sinceUpdate=2023-01-01&page=1
https://www.labodata.com/api/v1/product/search.json?email=YOUR@EMAIL&secret=YOUR_KEY& ... &order=title-asc&page=1
https://www.labodata.com/api/v1/product/search.json?email=YOUR@EMAIL&secret=YOUR_KEY& ... &order=date-desc&page=1
https://www.labodata.com/api/v1/product/search.json?email=YOUR@EMAIL&secret=YOUR_KEY& ... &order=id-desc&page=1
https://www.labodata.com/api/v1/product/search.json?email=YOUR@EMAIL&secret=YOUR_KEY& ... &order=purchase-desc&page=1
```
Réponse : Voir le fichier `product/search.json`
### Visualiser le détail d'une fiche produit complète ( textes + images )
Cette requête permet de visualiser une fiche produit complète.
*A noter : les liens images et documents ont une durée de vie d'une heure maximum.*
Requête *(payante >> 1.5 crédit)* :
```
https://www.labodata.com/api/v1/product/full.json?email=YOUR@EMAIL&secret=YOUR_KEY&id=999
```
Réponse : Voir le fichier `product/full.json`
### Visualiser UNIQUEMENT les contenus textuels d'une fiche produit
Cette requête permet de visualiser les textes d'une fiche produit.
*A noter : les documents ont une durée de vie d'une heure maximum.*
Requête *(payante >> 1 crédit)* :
```
https://www.labodata.com/api/v1/product/content.json?email=YOUR@EMAIL&secret=YOUR_KEY&id=999
```
Réponse : Voir le fichier `product/content.json`
### Visualiser UNIQUEMENT les contenus visuels d'une fiche produit
Cette requête permet de consulter les visuels d'une fiche produit.
*A noter : les liens images ont une durée de vie d'une heure maximum.*
Requête *(payante >> 1 crédit)* :
```
https://www.labodata.com/api/v1/product/image.json?email=YOUR@EMAIL&secret=YOUR_KEY&id=999
```
Réponse : Voir le fichier `product/image.json`
### Soumettre une fiche produit
Cette requête vous permet de soumettre une fiche produit au format POST et de gagner des crédits si votre fiche est validée par notre équipe.
Requête *(gratuite)* :
```
https://www.labodata.com/api/v1/product/suggest.json
```
Structure POST :
```
[
email : "YOUR@EMAIL"
secret : "YOUR_KEY"
product : [
private : "0"
brand_id : "2"
sale_start : "2016-01-01"
sale_end : "2020-01-01"
type : "normal"
code : "0000011122222"
additional_code : [
"0000011122222"
"0011122"
"..."
]
cis_code : "61234567"
minimum_age : "2M"
life_after_first_use : "7J"
ability_to_drive : "3"
seen_tv : "0"
bio : "0
http_ansm1 : "http://your-url..."
http_ansm2 : ""
http_other1 : "http://your-url..."
http_other2 : ""
max_quantity : "0"
weight : "90"
volume : "20 g"
unit : "1"
comment : null
title_fr : "Title"
content_fr : "
Content...
"
google_category_fr : "Santé et beauté > ... > ..."
additional_content : [
[
title_fr : "Title"
content_fr : "Content...
"
]
[
title_fr : "Title"
content_fr : "Content...
"
]
]
retail_price : [
value : "120.0"
currency : "EUR"
vat : "20.0"
]
categories_ids : [
"10"
"20"
"30"
"40"
]
images : [
"https://your-website/assets/image1.jpg"
"https://your-website/assets/image2.jpg"
"https://your-website/assets/image3.png"
]
documents : [
"https://your-website/assets/document1.doc"
"https://your-website/assets/document2.pdf"
]
]
]
```
Réponse : voir le fichier `product/suggest.json`