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.