Обзор API
REST API ArchiCore позволяет интегрировать анализ архитектуры в ваши рабочие процессы.
Базовый URL
https://api.archicore.io/api/v1
Аутентификация
Все запросы требуют аутентификации через Bearer token:
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://api.archicore.io/api/v1/projects
См. Аутентификация для получения API-ключей.
Формат ответа
Все ответы в JSON:
{
"success": true,
"data": { ... }
}
Ответы с ошибкой:
{
"success": false,
"error": "Сообщение об ошибке",
"code": "ERROR_CODE"
}
HTTP-коды статуса
| Код | Описание |
|---|---|
200 | Успех |
201 | Создано |
400 | Неверный запрос |
401 | Не авторизован |
403 | Доступ запрещён |
404 | Не найдено |
429 | Слишком много запросов |
500 | Внутренняя ошибка сервера |
Лимиты запросов
| Тариф | Запросов/день | Запросов/минуту |
|---|---|---|
| Free | 100 | 10 |
| Pro | 10,000 | 100 |
| Enterprise | Без лимита | 1,000 |
Эндпоинты
Проекты
| Метод | Эндпоинт | Описание |
|---|---|---|
GET | /projects | Список проектов |
POST | /projects | Создать проект |
GET | /projects/:id | Детали проекта |
DELETE | /projects/:id | Удалить проект |
POST | /projects/:id/index | Запустить индексацию |
Анализ
| Метод | Эндпоинт | Описание |
|---|---|---|
POST | /projects/:id/search | Семантический поиск |
POST | /projects/:id/ask | AI-ассистент |
GET | /projects/:id/metrics | Метрики кода |
GET | /projects/:id/security | Результаты сканирования |
POST | /projects/:id/analyze | Анализ влияния |
Вебхуки
| Метод | Эндпоинт | Описание |
|---|---|---|
GET | /webhooks | Список вебхуков |
POST | /webhooks | Создать вебхук |
DELETE | /webhooks/:id | Удалить вебхук |