API publique · v1
Documentation développeur
Tous les endpoints publics du registre Sannmerk. Réponses JSON, cache edge 60s, headers CORS ouverts. Pour le support commercial (SLA + quota étendu), contactez /contact?intent=api.
Conventions
- **Base URL** : `https://sannmerk.com/v1/sannmerk` - **Format** : `application/json` (GET only) - **Auth** : aucune pour les endpoints publics - **Cache** : 60s côté edge, 3600s pour les listings de taxonomie - **Rate limit** : 60 requêtes/minute par IP (burst 120) - **Erreurs** : HTTP standard, body `{"detail": "..."}`
Recherche et navigation
Endpoints de base pour chercher un produit, parcourir les marques et les catégories.
GET /products?q=>in=&brand=&category=&source=&page=
Recherche plein texte sur les variantes. Retourne jusqu'à 24 fiches par page avec prix observé et identifiants.
Voir la source officielleGET /product-masters?q=&brand=&category=&source=
Recherche au niveau produit maître. Un maître regroupe toutes les variantes d'un même produit (plusieurs sources, plusieurs formats).
Voir la source officielleGET /products/{key}
Détail d'une variante par slug, UUID ou GTIN.
Voir la source officielleGET /product-masters/{key}
Détail d'un produit maître avec toutes ses variantes liées.
Voir la source officielleGET /autocomplete?q=
Suggestions à la saisie. Renvoie produits, marques et GTIN valides. Debounce recommandé côté client (180 ms).
Voir la source officielleGET /compare?slugs=a,b,c
Tableau côte à côte de 2 à 4 produits (mêmes champs que /products/{key}).
Voir la source officielleMarques et catégories
Annuaires et listes de taxonomie.
GET /brands
Répertoire paginé des marques. Tri alphabétique ou par nombre de produits. Cache 24h.
Voir la source officielleGET /brand/{slug}
Page d'une marque avec ses produits, son propriétaire, ses sources.
Voir la source officielleGET /category/{code}
Liste des produits d'une catégorie (ex: health.drug, health.natural).
Voir la source officielleGET /facets
Compteurs par catégorie, source et marque. Utile pour les filtres d'UI.
Voir la source officielleGouvernance et transparence
Endpoints de transparence pour les auditeurs, journalistes et autorités.
GET /dataset
Manifeste public du jeu de données (compteurs globaux, licences, sources actives).
Voir la source officielleGET /sync-status
État de synchronisation des sources (DPD, LNHPD). Date de dernière ingestion par source.
Voir la source officielleGET /observatory
Signaux récents : nouveaux produits, top marques, sources actives.
Voir la source officielleGET /source-policies
Politique d'ingestion par source : URL du flux, licence, juridiction, dernière vérification.
Voir la source officielleFlux et syndication
Endpoints pour intégrer le registre dans d'autres applications (flux RSS, sitemap, Open Data).
GET /changelog.xml
Flux RSS 2.0 des notes de version (mêmes items que /changelog sur le site).
Voir la source officielleGET /sitemap
Sitemap XML du registre (produits, marques, catégories, sources). Cache 1h.
Voir la source officielleGET /brand/{slug}/feed.xml
Flux RSS 2.0 des nouveaux produits d'une marque spécifique.
Voir la source officielleGET /category/{code}/feed.xml
Flux RSS 2.0 des nouveaux produits d'une catégorie spécifique.
Voir la source officielleLimites et quotas
- **Endpoints publics** : 60 requêtes/minute par IP (burst 120) - **Endpoints taxonomy** (`/facets`, `/sitemap`) : 30 requêtes/minute - **Pas d'authentification** sur les endpoints publics. Pour un SLA et un quota étendu, contactez /contact?intent=api. - **CORS** : tous les endpoints publics exposent `Access-Control-Allow-Origin: *`.
Besoin d'un accès commercial ?
SLA contractuel, quota étendu, support prioritaire, webhooks (alertes rappels Santé Canada, ingestion d'événements). Demandez un devis.
Demander un devis