Entwickler
Eine API für Suche, Empfehlungen und Antworten.
Der OpenAPI-Vertrag wird aus dem Live-Router generiert, sodass die Dokumentation niemals ein nicht existierendes Endpunkt beschreibt. Verwenden Sie die REST-API, das TypeScript- oder Python-SDK oder das einbettbare Widget.
- Operationen
- 176
- Endpunkte
- 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 vom Router
Der Vertrag wird aus dem Code generiert, der Anfragen bedient und in CI überprüft, sodass Dokumentation und SDKs nicht von der API abweichen können.
TypeScript- und Python-SDKs
Typisierte Clients, generiert aus dem Vertrag, mit Wiederholungen bei vorübergehenden Fehlern.
Gescopte Schlüssel
Schlüssel tragen Bereiche, können ablaufen und mit einer Schonfrist rotiert werden; Browser erhalten 15-minütige Sitzungstokens anstelle von Schlüsseln.
Signierte Webhooks
Ereignisse für Importe, Connector-Läufe und Experimente, signiert mit HMAC und bei einem 1 min → 12 h Intervall wiederholt.
Stabile Fehlercodes
Jeder Fehler hat einen öffentlichen Code, eine Nachricht und eine Anfragen-ID; interne Details dringen niemals in Antworten durch.
Vorhersehbare Grenzen
Pro-Schlüssel-Ratenlimits mit Standard-Headern und Planquoten, die Sie über die API einsehen können.
Weiter: Verbinden Sie Ihre Daten oder lesen Sie, wie andere Teams die Suche messen.