🧩 API platform
Micro-services de recherche/prix devant SerpApi (clé serveur, cache BDD, auth, rate limiting).
Base URL
https://price.test.gpa07.com
Authentification
Clé requise :
?key= ou en-tête X-Api-KeyRate limit
60 req / 60 s
· en-têtes
X-RateLimit-*Micro-services
Proxy SerpApi brut (passthrough) + cache BDD.
| Param | Type | Requis | Description |
|---|---|---|---|
q |
string | oui | Requête de recherche |
engine |
string | — | Moteur SerpApi (google, google_shopping, ebay, bing…) |
nocache |
0|1 | — | Bypass cache (force un appel amont) |
Exemple
curl "https://price.test.gpa07.com/api/search?q=iphone+15&engine=google&key=VOTRE_CLE"
Pipeline multi-engine (Google Shopping + eBay) : dédoublonnage 3 niveaux + grouping par type de source + fourchette de prix.
| Param | Type | Requis | Description |
|---|---|---|---|
q |
string | oui | Requête produit (réf OEM + désignation + véhicule) |
gpa_price |
number | — | Prix GPA (€) → ajoute le positionnement + enregistre un instantané |
label |
string | — | Étiquette GPA associée (pour l'historique de positionnement) |
nocache |
0|1 | — | Bypass cache |
Exemple
curl "https://price.test.gpa07.com/api/shopping?q=620905715R+pompe+ABS+Renault&key=VOTRE_CLE"
Résout une étiquette GPA (ex. Z1-1937C) → désignation, réf OEM, véhicule (API GPA ou jeu local).
| Param | Type | Requis | Description |
|---|---|---|---|
code |
string | oui | Identifiant étiquette GPA |
Exemple
curl "https://price.test.gpa07.com/api/etiquette?code=Z1-1937C&key=VOTRE_CLE"
GET
/api/recent
🔑 clé Liste des dernières recherches en cache (cliquables côté front).
| Param | Type | Requis | Description |
|---|---|---|---|
mode |
string | — | all | shopping | search |
limit |
integer | — | Nb max d'entrées (déf. 20) |
Exemple
curl "https://price.test.gpa07.com/api/recent?mode=shopping&limit=15&key=VOTRE_CLE"
Historique des positionnements prix GPA enregistrés (price_snapshots).
| Param | Type | Requis | Description |
|---|---|---|---|
limit |
integer | — | Nb max d'entrées (déf. 20) |
Exemple
curl "https://price.test.gpa07.com/api/snapshots?limit=20&key=VOTRE_CLE"
GET
/health
public Healthcheck : statut DB, présence clé SerpApi, stats cache, config rate limit.
Exemple
curl "https://price.test.gpa07.com/health"
Découverte programmatique : GET https://price.test.gpa07.com/api renvoie ce catalogue en JSON.
Process complet : docs/api-platform.md.