API и OpenAPI

Что это простыми словами

API — адрес, по которому программа может искать компании так же, как вы на сайте. OpenAPI — машиночитаемая «инструкция» к этому API (файл YAML/JSON), которую понимают ChatGPT Actions, многие IDE и ИИ-студии.

Адреса

• База API: https://asknayda.ru/api/v1
• Схема OpenAPI (YAML): https://asknayda.ru/api/v1/openapi.yaml
• Схема OpenAPI (JSON): https://asknayda.ru/api/v1/openapi.json
• Копия схемы на сайте: https://asknayda.ru/openapi.yaml
• Краткая шпаргалка для ИИ: https://asknayda.ru/llms.txt

Полный чеклист регистрации в консолях: файл docs/openapi/ai-registration.md в репозитории проекта (для команды) — на этой странице достаточно шагов ниже.

Что можно вызывать без входа

• GET /search — поиск
• GET /suppliers/{id} — карточка (UUID или ИНН)
• GET /suppliers/{id}/similar — похожие
• GET /categories — категории
• GET /settings/public — публичные настройки
• GET /healthz — проверка, что API жив

Claim (забрать карточку) и регистрация тоже описаны в OpenAPI, но требуют аккаунт и JWT — для ИИ-агентов на старте лучше оставить только поиск и карточки.

Пример: поиск через curl

curl -sS 'https://asknayda.ru/api/v1/search?q=ПЛК&limit=5' | head -c 800
curl -sS 'https://asknayda.ru/api/v1/suppliers/7707083893' | head -c 800
curl -sS 'https://asknayda.ru/api/v1/openapi.yaml' | head -20

Подключение для «обычного» пользователя ИИ

ChatGPT (Custom GPT → Actions)

1. Создайте GPT → раздел Actions → Create new action.
2. Import from URL: https://asknayda.ru/api/v1/openapi.yaml
3. Authentication: None (для поиска и карточек).
4. Privacy policy: https://asknayda.ru/legal/privacy
5. В инструкции GPT напишите: искать только через API Найды, не выдумывать ИНН и контакты, давать ссылки на карточки asknayda.ru.

Google Gemini

Gemini обычно не подключает весь OpenAPI одним кликом. Выберите 3–4 операции (searchSuppliers, getSupplier, getSimilarSuppliers, listCategories) и опишите их как function declarations; ваш код вызывает https://asknayda.ru/api/v1 и возвращает ответ модели. Подробности — в документации Google Function calling.

Yandex AI Studio (MCP Hub)

1. В AI Studio откройте MCP Hub → создайте MCP-сервер поверх REST API (не External MCP).
2. Base: https://asknayda.ru/api/v1. Добавьте только read-инструменты: searchSuppliers, getSupplier, getSimilarSuppliers, listCategories. Auth не нужна. Схема для сверки: https://asknayda.ru/api/v1/openapi.yaml.
3. Создайте агента → Tools → Add MCP → выберите этот сервер. В промпте: не выдумывать факты, ссылаться на карточки asknayda.ru.
4. Не подключайте claim, auth, admin и billing.

Правила хорошего тона

• Не долбите API без паузы — разумные лимиты и кэш на своей стороне.
• Не публикуйте чужие JWT и пароли.
• Данные справочные; условия использования — пользовательское соглашение.

Вернуться: обзор справки · как искать