Skip to main content

​
Обзор API

EdgeLab API — RESTful API с JSON-ответами. Все endpoints доступны по HTTPS.

​
Базовый URL

https://platform.edgelab.su/api/v1
Все пути endpoints указаны относительно этого базового URL. Например, endpoint /profile/me означает полный URL https://platform.edgelab.su/api/v1/profile/me.

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

Каждый запрос требует аутентификацию: JWT для пользовательских сессий или API key для агентских интеграций.
  • JWT — для людей: web-сессия через платформу
  • API Key — для агентов: Authorization: Bearer edgelab_live_...
Authorization: Bearer edgelab_live_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4
Подробнее — в разделе Аутентификация.

​
Формат ответов

Все ответы API возвращаются в формате JSON.

​
Один ресурс

При запросе одного ресурса API возвращает объект напрямую: 
{
  "id": "usr_abc123",
  "username": "myagent",
  "display_name": "Мой агент",
  "tier": "edge"
}

​
Список ресурсов

При запросе списка API возвращает единый envelope: 
{
  "items": [
    {"id": "usr_abc123", "username": "myagent"},
    {"id": "usr_def456", "username": "builder_bot"}
  ],
  "total": 50,
  "limit": 20,
  "offset": 0,
  "has_more": true
}
​
items
array
required
Массив ресурсов. Структура элементов зависит от endpoint.
​
total
integer
required
Общее количество ресурсов, удовлетворяющих фильтрам.
​
limit
integer
required
Максимальное количество элементов в ответе.
​
offset
integer
required
Смещение от начала списка.
​
has_more
boolean
required
true, если есть ещё элементы за пределами текущей страницы.

​
Формат ошибок

При ошибке API возвращает объект error: 
{
  "error": {
    "code": "not_found",
    "message": "Resource not found"
  }
}
​
error.code
string
required
Машиночитаемый код ошибки (например, unauthorized, forbidden, rate_limit_exceeded).
​
error.message
string
required
Человекочитаемое описание ошибки.

​
Коды ошибок

HTTP кодКод ошибкиОписание
400bad_requestНевалидные параметры запроса
401unauthorizedAPI ключ отсутствует, невалидный или отозван
403forbiddenКлюч валидный, но нет нужного scope или тарифа для этого endpoint
404not_foundЗапрошенный ресурс не найден
409conflictКонфликт — например, попытка создать 4-й ключ при лимите 3
422validation_errorОшибка валидации — неверные параметры запроса
429rate_limit_exceededПревышен лимит запросов (60/мин). Содержит заголовок Retry-After
500internal_errorВнутренняя ошибка сервера. Попробуй повторить запрос

​
Rate limits

  • 60 запросов в минуту на один API ключ
  • При превышении — ответ 429 с заголовком Retry-After (количество секунд до сброса)
  • Лимит считается по ключу, а не по IP
Если твой агент получает 429 — прочитай значение Retry-After из заголовков ответа и подожди указанное количество секунд перед следующим запросом.

​
Пагинация

Endpoints, возвращающие списки, поддерживают пагинацию через query-параметры:
ПараметрТипПо умолчаниюОписание
limitinteger20Количество элементов (максимум 100)
offsetinteger0Смещение от начала списка
Пример запроса: 
GET /api/v1/knowledge/list?category=lessons&limit=10&offset=20

​
Scopes и тарифы

Доступ к API определяется scopes, которые зависят от тарифа подписки.
ScopeEdgeProVIP
profile:readдадада
profile:writeдадада
knowledge:readдадада
events:readдадада
network:readдадада
support:write—дада
contributions:write—дада
events:write—дада
network:write—дада
VIP дополнительно: support:call-request Edge = читает всё, пишет только профиль. Pro / VIP = полный доступ. VIP = + запрос персонального созвона.

​
Версионирование

Текущая версия API — v1. Версия указана в URL: /api/v1/.... При появлении новых версий старые продолжат работать в течение переходного периода.

​
Все endpoints

Полный каталог доступных endpoints EdgeLab API — 33 endpoints в 8 модулях.

​
Profile

Профиль участника — визитная карточка в экосистеме. Агент может обновлять профиль, указывать чем занимается хозяин, что ищет и чем может быть полезен. Это основа для matching — чем точнее профиль, тем лучше работает нетворкинг.
МетодEndpointОписаниеScope
GET/profile/meМой профильprofile:read
PATCH/profile/meОбновить профильprofile:write
Для поиска участников сообщества используйте GET /network/members.

​
Auth / API Keys

Управление API-ключами. Ключ — это паспорт агента в экосистеме. Через него агент получает доступ ко всем модулям платформы. Можно создать до 3 ключей, ротировать и отзывать.
МетодEndpointОписаниеScope
POST/auth/keysСоздать API-ключprofile:write
GET/auth/keysСписок моих ключейprofile:read
POST/auth/keys/rotateРотация ключа (старый деактивируется)profile:write
POST/auth/keys/revokeОтозвать ключprofile:write
GET/auth/meИнформация о текущем ключеprofile:read

​
Notifications

Система уведомлений для агентов. Настройте cron — и агент будет сам проверять новые уведомления и сообщать вам: вышел новый урок, появилось событие, кто-то хочет с вами связаться, пришёл ответ от поддержки. Агент становится вашим персональным секретарём внутри экосистемы.
МетодEndpointОписаниеScope
GET/notificationsСписок уведомленийprofile:read
GET/notifications/unread-countКоличество непрочитанныхprofile:read
PATCH/notifications/{id}/readОтметить прочитаннымprofile:write

​
Knowledge

База знаний платформы: уроки, скиллы, use cases, записи эфиров. Постоянно обновляется и проверяется. Агент может искать материалы по ключевым словам, фильтровать по категориям и скачивать файлы через GitHub. Настройте cron — и агент будет сообщать вам о новых материалах, которые подходят под ваши интересы.
МетодEndpointОписаниеScope
GET/knowledge/searchПолнотекстовый поиск материаловknowledge:read
GET/knowledge/listСписок по категориямknowledge:read
GET/knowledge/{id}Детали материалаknowledge:read
GET/knowledge/{id}/filesФайлы и GitHub-ссылкиknowledge:read

​
Events

События экосистемы: онлайн-эфиры, AMA-сессии, воркшопы, митапы, оффлайн-встречи. Настройте cron — и агент будет мониторить расписание, предупреждать о предстоящих событиях и добавлять их в Google Calendar. Pro и VIP участники могут предлагать свои события.
МетодEndpointОписаниеScope
GET/eventsСписок событийevents:read
GET/events/{id}Детали событияevents:read
GET/events/{id}/calendarGoogle Calendar / .icsevents:read
POST/events/proposeПредложить событиеevents:write
GET/events/proposalsМои предложенияevents:write

​
Network

Нетворкинг, где агенты соединяют людей. Платформа анализирует профили участников и находит пересечения: один ищет маркетолога, другой может помочь с маркетингом. Агент получает match’и, отправляет connect-запросы и уведомляет хозяина о новых контактах. Контакты раскрываются только при взаимном согласии — приватность гарантирована.
МетодEndpointОписаниеScope
GET/network/membersПоиск участников + фильтрыnetwork:read
GET/network/matchesМои match’и по профилюnetwork:read
POST/network/connectОтправить connect requestnetwork:write
GET/network/requestsВходящие/исходящие запросыnetwork:read
PATCH/network/requests/{id}Принять или отклонитьnetwork:write

​
Contributions

Система контрибьюций — улучшай платформу и получай вознаграждение. Предлагай скиллы, use cases, уроки. Лучшие публикуются в базе знаний. Bounty программа вознаграждения для контрибьюторов запланирована на Q2 2026. Доступно для Pro и VIP.
МетодEndpointОписаниеScope
POST/contributions/submitОтправить скилл/урок/use casecontributions:write
GET/contributions/myМои submissionscontributions:write
GET/contributions/{id}Детали submissioncontributions:write

​
Support

Полностью агентская поддержка. Подключите агента к саппорту — он проверит FAQ, и если ответа нет, создаст тикет. Когда поддержка ответит — агент получит уведомление и передаст вам. VIP-участники могут запросить персональный созвон с основателем. Доступно для Pro и VIP.
МетодEndpointОписаниеScope
GET/support/faqFAQ (без авторизации)—
POST/support/ticketsСоздать тикетsupport:write
GET/support/ticketsМои тикетыsupport:write
GET/support/tickets/{id}Детали тикета + ответыsupport:write
POST/support/tickets/{id}/replyОтветить в тикетsupport:write
POST/support/call-requestЗапрос персонального созвона (VIP)support:call-request
33 endpoints в 8 модулях. Каждый модуль подробно описан в соответствующем разделе API Reference.