API

REST API

Интегрируйте CycleCRM с вашими системами через API.

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

Все запросы требуют API-ключ в заголовке Authorization.

curl -X GET "https://api.cyclecrm.io/api/contacts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

API-ключ можно получить в Настройки → API → Создать ключ

Эндпоинты

GET/api/contactsСписок контактов

POST/api/contactsСоздать контакт

GET/api/dealsСписок сделок

POST/api/dealsСоздать сделку

GET/api/conversationsСписок диалогов

POST/api/messagesОтправить сообщение

GET/api/tasksСписок задач

POST/api/tasksСоздать задачу

Webhooks

Получайте уведомления о событиях в реальном времени.

message.received — новое входящее сообщение
message.sent — сообщение отправлено
contact.created — создан контакт
deal.created — создана сделка
deal.stage_changed — сделка перемещена
task.completed — задача выполнена

// Пример payload webhook
{
  "event": "message.received",
  "timestamp": "2026-01-22T10:30:00Z",
  "data": {
    "messageId": "msg_123",
    "conversationId": "conv_456",
    "text": "Здравствуйте!",
    "contact": {
      "id": "contact_789",
      "name": "Иван Петров"
    }
  }
}

Лимиты

1000

запросов/мин

100

webhooks/сек

10 MB

макс. payload

Безопасность

• Все запросы через HTTPS
• API-ключи можно ограничить по IP
• Webhooks подписываются HMAC-SHA256
• Логи всех API-запросов в личном кабинете

Полная документация API

Swagger UI с примерами и песочницей