Développeurs

Une API pour la recherche, les recommandations et les réponses.

Le contrat OpenAPI est généré à partir du routeur en direct, donc les docs ne décrivent jamais un point de terminaison qui n'existe pas. Utilisez l'API REST, le SDK TypeScript ou Python, ou le widget intégrable.

Lire les docsObtenez une clé API
Opérations
176
Points de terminaison
147
OpenAPI
3.1.0
curl -X POST https://api.example.com/api/v1/indexes/products/search \
  -H "Authorization: Bearer $AAC_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q": "кросовки найк",
       "per_page": 20,
       "facet_by": "brand,size"}'

OpenAPI depuis le routeur

Le contrat est généré à partir du code qui sert les requêtes et vérifié en CI, donc les docs et SDKs ne peuvent pas diverger de l'API.

SDKs TypeScript et Python

Clients typés générés à partir du contrat, avec des réessais sur les erreurs transitoires.

Clés à portée limitée

Les clés portent des portées, peuvent expirer et être tournées avec une période de grâce; les navigateurs obtiennent des jetons de session de 15 minutes au lieu de clés.

Webhooks signés

Événements pour les importations, exécutions de connecteurs et expériences, signés avec HMAC et réessayés sur une échelle de 1 min → 12 h.

Codes d'erreur stables

Chaque erreur a un code public, un message et un identifiant de requête; les détails internes ne fuient jamais dans les réponses.

Limites prévisibles

Limites de taux par clé avec en-têtes standard, et quotas de plan que vous pouvez lire via l'API.

Suivant : connectez vos données ou lisez comment d'autres équipes mesurent la recherche.

IntégrationsGuidesSécurité