CRUD API (design-time stage).
CRUD API служит для создания Баз Знаний, наполения их документами и публикации.
Жизненный цикл БЗ:
Создание. БЗ имеет имя, настройки языка, режима дообучения и apikey service_token для доступа к опубликованному сервису QNA.
Наполнение документами. Документ - это (вопрос, ответ, опционально формулировки вопроса, файловые атачи)
Публикация. Опубликованная БЗ предоставляет сервис ответов на вопросы (см QNA API ниже)
Редактирование конента, модерация и прием рекоммендаций документов и формулировок.
Удаление БЗ
Аутентификация
user_token - строковый ключ пользователя (access token, apikey) для доступа к CRUD API.
Токен может быть передан двумя способами:
Предпочтительный: http header AUTOFAQ-User-Token
Удобный для HTTP GET запросов: URL query string parameter user_token
Пример
Тривиальный пример жизненного цикла см скрипт test_winnie_pooh.py в атаче.
Пример добавления документа с формулировками:
CRUDAPI_URL=https://api.autofaq.ai/v1/setup USER_TOKEN=9d9d68ee3cc14c4d997f7ca076ed14ac \ python3 tutorial_crud_paraphrase.py
RESTful версия CRUD API, которая описана на https://app.swaggerhub.com/apis-docs/denis_kiselev/autofaq_crud_api/1.0
Deprecated json rpc CRUD API: https://autofaq.ai/api_doc
Квоты
Квоты на доступ к учетной записи (user_token):
100 запросов в минуту
100000 запросов в день
QNA API (run-time stage).
QNA API служит для запросов к опубликованной базе знаний (БЗ) и сбора обратной связи.
"Отправить запрос": https://autofaq.ai/api_doc#rec56009662
"Отправить обратную связь": https://autofaq.ai/api_doc#rec56022196
Аутентификация
service_token - строковый ключ опубликованный БЗ (access token, apikey) для доступа к QNA API.
Токен передается в JSON BODY POST запросом. Схема запроса и параметры см в примере ниже.
Пример
В качестве примера использования см вызовы методов /query и /click в демо скипте test_winnie_pooh.py
Квоты
Квоты на доступ к одной опубликованной БЗ (service_token):
900 запросов в минуту
200000 запросов в день