API Документация

curl -X POST https://app.ai-calls.future-optic.pro/api/analyze \
  -F "call_id=test-001" \
  -F "clinic_id=1" \
  -F "api_token=clinic_token_..." \
  -F "operator_id=123" \
  -F "audio_url=https://example.com/recording.mp3"

curl -X POST https://app.ai-calls.future-optic.pro/api/analyze \
  -F "call_id=call-2025-10-21-001" \
  -F "clinic_id=1" \
  -F "api_token=clinic_token_..." \
  -F "operator_id=123" \
  -F "full_response_key=clinic_resp_..." \
  -F "file=@/path/to/recording.mp3" \
  -F "call_datetime=2025-10-21T14:30:00+03:00" \
  -F "datetime_format=iso8601"

curl -X POST https://app.ai-calls.future-optic.pro/api/analyze \
  -F "call_id=call-2025-10-21-002" \
  -F "clinic_id=1" \
  -F "api_token=clinic_token_..." \
  -F "operator_id=456" \
  -F "full_response_key=clinic_resp_..." \
  -F "audio_url=https://your-crm.com/recordings/call123.mp3" \
  -F "call_datetime=2025-10-21 14:30:00" \
  -F "datetime_format=sql_datetime" \
  -F "timezone=Europe/Moscow"

curl -X POST https://app.ai-calls.future-optic.pro/api/analyze \
  -F "call_id=test-001" \
  -F "clinic_id=1" \
  -F "api_token=clinic_token_..." \
  -F "audio_url=https://example.com/test.mp3" \
  -F "call_datetime=21.10.2025 14:30" \
  -F "datetime_format=ru_datetime" \
  -F "timezone=MSK"

curl -X POST https://app.ai-calls.future-optic.pro/api/analyze \
  -F "call_id=call-2025-10-21-003" \
  -F "clinic_id=1" \
  -F "api_token=clinic_token_..." \
  -F "operator_id=789" \
  -F "full_response_key=clinic_resp_..." \
  -F "file=@/path/to/recording.mp3" \
  -F "trim_start_seconds=5.0" \
  -F "call_datetime=1761046245" \
  -F "datetime_format=unix_timestamp" \
  -F "timezone=UTC+3"

curl -X POST https://app.ai-calls.future-optic.pro/api/analyze \
  -F "call_id=call-2025-10-21-001" \
  -F "clinic_id=1" \
  -F "api_token=clinic_token_..." \
  -F "operator_id=123" \
  -F "full_response_key=clinic_resp_..." \
  -F "file=@/path/to/recording.mp3" \
  -F "call_datetime=2025-10-21T14:30:00+03:00" \
  -F "datetime_format=iso8601"

{
  "call_id": "call-2025-10-21-001",
  "clinic_id": 1,
  "operator_id": "f8b58d08-1733-4508-8146-51abd2a9fb4b",
  "operator_id_custom": 123,
  "call_datetime": "2025-10-21T14:30:00+03:00",
  "skip_db_save": false,
  "final_score": 87
}

{
  "call_id": "call-2025-10-21-001",
  "clinic_id": 1,
  "operator_id": "f8b58d08-1733-4508-8146-51abd2a9fb4b",
  "operator_id_custom": 123,
  "call_datetime": "2025-10-21T14:30:00+03:00",
  "skip_db_save": false,

  "transcript": "Здравствуйте, клиника Здоровье, меня зовут Анна, чем могу помочь? - Добрый день, я хотел бы записаться на прием к терапевту...",

  "final_score": 87,

  "summary": "Звонок от потенциального клиента с запросом на запись к терапевту. Оператор Анна вежливо поприветствовала клиента, представилась по имени, уточнила детали и успешно записала на прием. Проинформировала об акции для новых клиентов.",

  "kpi_scores": {
    "greeting": {
      "score": 10,
      "comment": "Отлично: оператор поздоровался, представился и назвал клинику"
    },
    "politeness": {
      "score": 9,
      "comment": "Использовал вежливые обращения на протяжении всего разговора"
    },
    "active_listening": {
      "score": 8,
      "comment": "Внимательно слушал клиента, уточнял детали"
    },
    "product_knowledge": {
      "score": 9,
      "comment": "Знает цены и расписание врачей"
    },
    "objection_handling": {
      "score": 7,
      "comment": "Корректно ответил на вопрос о цене"
    },
    "appointment_booking": {
      "score": 10,
      "comment": "Успешно записал клиента, подтвердил дату и время"
    },
    "promo_communication": {
      "score": 9,
      "comment": "Проинформировал о скидке 20% для новых клиентов"
    },
    "call_structure": {
      "score": 8,
      "comment": "Структурированный разговор с четкими этапами"
    },
    "closing": {
      "score": 8,
      "comment": "Правильно завершил разговор, пожелал доброго дня"
    }
  },

  "insights": {
    "strengths": [
      "Вежливое и профессиональное общение",
      "Представление по имени и названию клиники",
      "Проактивное информирование об акциях",
      "Успешная запись на прием"
    ],
    "areas_for_improvement": [
      "Можно более активно работать с возражениями по цене",
      "Уточнить был ли клиент у нас ранее для применения акции"
    ],
    "strategic_recommendations": [
      "Добавить в скрипт вопрос о предыдущих визитах",
      "Обучить технике аргументации ценности услуг"
    ]
  },

  "flags": {
    "appointment_made": true,
    "target_call": true
  },

  "_processing": {
    "transcription_model": "gpt-4o-transcribe",
    "analysis_model": "gpt-5",
    "cost_usd": 0.05,
    "transcript_duration": 180,
    "timings_ms": {
      "transcription": 5000,
      "analysis": 7500
    }
  }
}

{
  "status": "healthy",
  "timestamp": "2025-10-31T09:32:49.439Z",
  "checks": {
    "database": {
      "status": "ok",
      "latency_ms": 1088
    },
    "application": {
      "status": "ok",
      "uptime_ms": 13249.027193
    }
  },
  "latency_ms": 1093,
  "version": "0.1.0"
}

curl https://app.ai-calls.future-optic.pro/api/healthz

import requests

response = requests.get('https://app.ai-calls.future-optic.pro/api/healthz')

if response.status_code == 200:
    data = response.json()
    print(f"System is {data['status']}")
    print(f"Database latency: {data['checks']['database']['latency_ms']}ms")
else:
    print("System is unhealthy!")