API-ключи

Два типа ключей, когда их использовать и как их создать.

API-ключи — это пароли для роботов (приложений). Есть два типа.

Два типа ключей

1. Ключ для поиска (`ss_search_*`)

Для чего:

Поиск товаров на сайте
Может только искать, не может менять товары

Где использовать:

На сайте в браузере (видимый в HTML — это нормально)
В мобильном приложении

Безопасность:

Может видеть только результаты поиска
Не может загружать или удалять товары
Не может видеть статистику

2. Ключ для загрузки (`ss_ingest_*`)

Для чего:

Загружать и обновлять товары
Может добавлять, менять и удалять товары

Где использовать:

Только на вашем сервере
Никогда в браузере
Никогда в мобильном приложении

Безопасность:

Скрыт на сервере
Может менять все товары в индексе
Берегите как пароль от почты

Создать ключ для поиска

В панели управления перейдите Поиск → Ключи API
Нажмите Создать ключ
Выберите Поиск
Введите название (например, "Мой сайт")
Нажмите Создать
Скопируйте ключ немедленно — он не будет показан снова

Вы получите ключ, начинающийся с ss_search_

Создать ключ для загрузки

В панели управления перейдите Поиск → Ключи API
Нажмите Создать ключ
Выберите Загрузка товаров
Введите название (например, "Синхронизация с магазином")
Нажмите Создать
Скопируйте ключ немедленно — он не будет показан снова

Вы получите ключ, начинающийся с ss_ingest_

Как использовать ключ поиска

На сайте в теге script:

<script 
  src="https://api.aacsearch.com/api/widget/widget.js"
  data-key="ss_search_ваш_ключ"
  data-index="товары"
>
</script>

Или в коде JavaScript:

fetch('https://api.aacsearch.com/api/search', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ss_search_ваш_ключ',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    index: 'товары',
    q: 'рубашка'
  })
})

Как использовать ключ для загрузки

На сервере (Node.js):

const key = 'ss_ingest_ваш_ключ';

// Загрузить товар
await fetch('https://api.aacsearch.com/api/ingest', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${key}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    index: 'товары',
    documents: [
      {
        id: '123',
        title: 'Красная рубашка',
        price: 1500
      }
    ]
  })
});