Cosbi
Документация в подготовке · Q3 2026

REST API для интеграции с любой вашей системой

Cosbi даёт программный доступ к нормализованным данным и сервисам платформы. Готовим публичную документацию OpenAPI 3.1 и SDK для JS/TS, Python, Go. Если вам нужен ранний доступ — пишите.

Получить ранний доступhttps://api.cosbi.tech
Production endpoint уже доступен: https://api.cosbi.tech/v1/* · для существующих клиентов с активной подпиской.
Что войдёт в публичный API

Программный доступ ко всему, что показывает интерфейс

6 групп эндпоинтов — от выгрузки данных до управления коннекторами. Полное покрытие фич платформы.

Data Export API

REST-эндпоинты для выгрузки нормализованных сущностей: сделки, контакты, компании, проводки, платежи. Форматы — JSON, CSV, Parquet. Стриминг для больших датасетов.

S3-push и автоматизация

Расписание автоматических выгрузок в ваш собственный S3-бакет. Webhook-уведомления о готовности. Идемпотентность и докачка с offset.

Identity Resolution API

Программный интерфейс к мастер-сущностям (entity_master). Поиск компании/контакта по ИНН, телефону, email, SKU. Создание master-id для интеграций.

Connector Framework

BaseConnector интерфейс для добавления собственных коннекторов в registry: testConnection, initialize, extractAll, mapToUnified. AES-256-GCM-шифрование credentials.

BigQuery / DataLens connector

Готовые коннекторы для построения собственных дашбордов поверх данных Cosbi в Google BigQuery или Yandex DataLens. Schema-aware маппинг.

Webhooks и события

Подписка на события платформы: новая сделка, изменение статуса, AI-инсайт, кассовый разрыв. Доставка с retry и dead-letter queue.

Пример запроса

Выгрузка сделок за период — одной командой

Авторизация по Bearer JWT. Курсорная пагинация для больших датасетов. Фильтры по статусу, дате, менеджеру, организации (для multi-tenant клиентов с правом cross-org).

  • · Стриминг ответа для выгрузок более 100 000 записей
  • · ETag и If-None-Match для эффективной синхронизации
  • · Rate-limit 600 запросов в минуту на токен
curl
# 1. Получить access token
curl -X POST https://api.cosbi.tech/v1/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "client_credentials",
    "client_id":     "ci_...",
    "client_secret": "cs_..."
  }'

# 2. Выгрузить сделки за май 2026 (JSON stream)
curl https://api.cosbi.tech/v1/deals \
  -H "Authorization: Bearer eyJhbGc..." \
  -G \
  --data-urlencode "from=2026-05-01" \
  --data-urlencode "to=2026-05-31" \
  --data-urlencode "fields=id,company,amount,stage,manager,closed_at" \
  --data-urlencode "format=jsonl"

# 3. Подписаться на webhook
curl -X POST https://api.cosbi.tech/v1/webhooks \
  -H "Authorization: Bearer eyJhbGc..." \
  -d '{
    "event": "deal.stage_changed",
    "url":   "https://your-system.example/cosbi"
  }'
Принципы дизайна

Как устроен API

OAuth 2.0 + JWT

Авторизация через OAuth 2.0 client credentials flow. Все запросы подписаны JWT с TTL и scope.

Multi-tenant изоляция

RLS-политики PostgreSQL обеспечивают полную изоляцию данных между организациями на уровне БД.

Открытая OpenAPI 3.1 спецификация

Полное описание эндпоинтов в OpenAPI. Генерация SDK для JS/TS, Python, Go из спецификации.

Roadmap публичного API

Когда станет доступно

Сейчас
Внутренний APILive

Работает в production. Используется приложением app.cosbi.tech и существующими клиентами с активной подпиской. Доступ — по индивидуальному соглашению.

Q3 2026
Публичная betaСкоро

OpenAPI 3.1 спецификация, OAuth 2.0, документация на api-docs.cosbi.tech, sandbox-окружение, генерируемые SDK для JS/TS.

Q4 2026
GA + SDKЗапланировано

Полный релиз, SDK для Python и Go, webhook delivery с retry, BigQuery/DataLens коннекторы.

2027
GraphQL и RealtimeЗапланировано

GraphQL endpoint для гибких запросов, Realtime-подписки через WebSocket для live-дашбордов.

Нужен ранний доступ к API?

Если вашему проекту нужна интеграция уже сейчас — расскажите о задаче. Дадим доступ к внутреннему API, поможем со схемой и first integration.

Связаться с командойПодробнее про Data Export