Разработчики

Один API для поиска, рекомендаций и ответов.

Контракт OpenAPI генерируется из активного маршрутизатора, поэтому документация никогда не описывает несуществующий конечный пункт. Используйте REST API, SDK для TypeScript или Python, или встраиваемый виджет.

Читать документациюПолучить ключ API
Операции
176
Конечные точки
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 из маршрутизатора

Контракт генерируется из кода, который обрабатывает запросы и проверяется в CI, поэтому документация и SDK не могут отклоняться от API.

SDK для TypeScript и Python

Типизированные клиенты, сгенерированные из контракта, с повторными попытками при временных ошибках.

Ключи с областью действия

Ключи имеют области действия, могут истекать и быть заменены с периодом льготы; браузеры получают 15-минутные сессионные токены вместо ключей.

Подписанные вебхуки

События для импорта, запуска коннекторов и экспериментов, подписанные с помощью HMAC и повторяемые по лестнице от 1 мин до 12 ч.

Стабильные коды ошибок

Каждая ошибка имеет публичный код, сообщение и идентификатор запроса; внутренние детали никогда не попадают в ответы.

Предсказуемые ограничения

Ограничения скорости на ключ с использованием стандартных заголовков и квоты плана, которые можно прочитать через API.

Далее: подключите ваши данные или узнайте, как другие команды измеряют поиск.

ИнтеграцииРуководстваБезопасность