Документация для разработчиков

REST API Integration

API-шлюз "GetAskio" позволяет автоматически верифицировать технические задания перед их передачей в разработку. Мы поддерживаем прямую REST-интеграцию и нативные вебхуки для "Jira", "Битрикс24" и "Trello".

Аутентификация

Все запросы к нашему API требуют наличия ключа доступа (API Key). Вы можете сгенерировать его в личном кабинете после оформления подписки ("Бизнес" или "Enterprise"). Ключ должен передаваться в HTTP-заголовке каждого запроса.

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxx

Проверка задачи (Verify Task)

Основной метод для семантического анализа. Настройте отправку вебхука из вашего таск-трекера при событии "Создание задачи" или "Перевод в статус To Do". Шлюз проанализирует текст и вернет решение о допуске.

POSThttps://api.getaskio.com/v1/verify-task

Пример запроса (JSON Payload):

{
  "system": "bitrix24",
  "ticket_id": "TASK-1042",
  "author_email": "pm@company.kz",
  "title": "Добавить кнопку оплаты",
  "description": "Нужна кнопка оплаты на главной.",
  "acceptance_criteria": ""
}

Пример ответа: 200 OK (Задача допущена)

{
  "status": "approved",
  "processing_time_ms": 420,
  "details": {
    "confidence_score": 0.95,
    "message": "Критерии приемки соответствуют стандартам качества."
  }
}

Пример ответа: 406 Not Acceptable (Блокировка)

{
  "status": "rejected",
  "error": "Missing_Acceptance_Criteria",
  "details": {
    "confidence_score": 0.99,
    "message": "Задача не содержит критериев приемки (DoD). Шлюз заблокировал передачу."
  }
}