Skip to main content
Acepeak
Разработчики

Создавайте звонки, сообщения и AI на Acepeak api.

REST-эндпоинты, вебхуки в реальном времени и первоклассные SDK. Аутентифицируйте api через bearer access token и отправьте первый запрос менее чем за пять минут.

place-call.sh
# Place a call from a US number
curl -X POST https://endpoints.acepeak.com/v1/calls \
  -H "Authorization: Bearer $ACEPEAK_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"from":"+18005551212",
       "to":"+14155551212",
       "answer_url":"https://your.app/answer"}'
Пять минут до вашего первого звонка

Быстрый старт.

  1. 01шаг

    Получить access token

    Войдите в дашборд Acepeak, откройте Developers → Tokens и создайте новый bearer token. Токены ограничены областью по окружению (sandbox или live) и ротируются из дашборда в любой момент.

    Внимание — храните live-токены на стороне сервера. Всё, что касается браузера, должно проходить через ваш бэкенд.

  2. 02шаг

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

    Каждый запрос использует аутентификацию по bearer-токену в заголовке Authorization.

    Authorization: Bearer YOUR_ACEPEAK_TOKEN
  3. 03шаг

    Отправьте первый запрос

    Совершите звонок, отправьте SMS или получите список своих номеров — выберите то, что подходит вашему сценарию. Вы должны увидеть JSON-список ваших телефонных номеров. Дальше вы можете совершать звонки, отправлять SMS, настраивать вебхуки и начинать разработку.

    curl https://endpoints.acepeak.com/v1/numbers \
      -H "Authorization: Bearer $ACEPEAK_TOKEN"
Что вы можете создать

Каждая возможность платформы доступна через REST.

Голосовые звонки

Совершайте исходящие звонки, управляйте входящими, переводите, организуйте конференции, записывайте, расшифровывайте. Программируемые потоки answer-URL, захват DTMF во время звонка, потоковая передача в реальном времени.

/v1/calls/v1/conferences/v1/recordings

Сообщения (SMS и MMS)

Отправляйте и принимайте на номерах US 10DLC, toll-free и коротких. Двусторонние, отчёты о доставке, соблюдение opt-out, объединённые длинные сообщения.

/v1/messages/v1/messages/inbound

Телефонные номера

Ищите, покупайте, переносите и освобождайте. Локальные US, toll-free и международные DID в 60+ странах.

/v1/numbers/v1/numbers/available/v1/numbers/port-orders

Пользователи и команды

Создавайте пользователей, назначайте роли, управляйте командами, настраивайте SSO. SCIM 2.0 для автоматизированного управления жизненным циклом с вашим IdP.

/v1/users/v1/teams/v1/sso

Вебхуки

Доставка в реальном времени событий звонков, сообщений и записей на ваш эндпоинт. Подписано HMAC-SHA256, повторные попытки с экспоненциальной выдержкой в течение 24 ч.

/v1/webhooks/v1/webhooks/{id}/events

AI-инструменты

Запускайте AI Receptionist, получайте расшифровки, извлекайте оценки тональности по звонку или по чату.

/v1/ai/receptionist/v1/ai/transcripts/v1/ai/sentiment
Аутентификация

Способы аутентификации.

Аутентификация по access token

Рекомендуется для бэкенд-сервисов. Bearer-токен отправляется в каждом запросе. Токены ограничены областью окружения, ротируются из панели управления и привязаны к конкретной роли для доступа по принципу наименьших привилегий.

Authorization: Bearer YOUR_ACEPEAK_TOKEN

OAuth 2.0

Для партнёрских приложений и интеграций маркетплейса. Authorization Code grant с PKCE. Используйте, когда ваше приложение действует от имени клиента, а не вашего собственного аккаунта.

  • Authorization Code + PKCE
  • Refresh-токены · по умолчанию 30 дней
  • Ограничение области по клиенту
Лимиты запросов и ошибки

Предсказуемо, задокументировано и никогда не молча.

Лимиты запросов

По умолчанию: 100 r/s на access token. Всплески до 200 r/s на короткие интервалы. При превышении платформа возвращает 429 с заголовком Retry-After.

Идемпотентность

Изменяющие запросы поддерживают заголовок Idempotency-Key . Используйте его в запросах POST, PUT и DELETE, чтобы повторы не приводили к двойному списанию или двойной отправке.

Коды ошибок

  • 400Bad requestПроверка не пройдена
  • 401UnauthorizedНедействительный или отсутствующий access token
  • 403ForbiddenУ токена нет нужного scope
  • 404Not foundРесурс не найден
  • 409ConflictНесоответствие идемпотентности или состояния
  • 429Rate limitedСнизьте темп — указан Retry-After
  • 5xxНа стороне сервераПовтор с экспоненциальной выдержкой
Вебхуки

События в реальном времени доставляются на ваш эндпоинт.

Подпишите HTTPS-эндпоинт на события звонков, сообщений и записей. Вебхуки подписываются HMAC-SHA256 — проверяйте подпись перед обработкой. Неудачные доставки повторяются с экспоненциальной задержкой до 24 часов. Любое событие можно воспроизвести из панели управления.

POST · /your-webhookSigned
{
  "id": "evt_01HW3...",
  "type": "call.completed",
  "created_at": "2026-04-30T10:42:00Z",
  "data": {
    "call_id": "CA_01HW...",
    "duration_sec": 184
  }
}
Подписано HMAC-SHA256 · безопасно для воспроизведения
Повторы с экспоненциальной задержкой 24 ч
Воспроизведите любое событие из панели управления
Фильтр по типу события · на каждый эндпоинт
SDK

Полноценные библиотеки, точно отражающие REST.

Node.jsnpm install @acepeak/sdkУстановка
Pythonpip install acepeakУстановка
PHPcomposer require acepeak/sdkУстановка
Gogo get github.com/acepeak/acepeak-goУстановка
Rubygem install acepeakУстановка
Лицензия MIT · тот же цикл релизов, что и у платформыPostman →
Версионирование

Стабильные URL. Предсказуемые обновления.

Версии интерфейса закреплены в URL (/v1/). Несовместимые изменения выходят под новой основной версией. Совместимые дополнения приходят в той же версии с записью в журнале изменений для разработчиков.

Политика устаревания

Функции остаются доступными в течение 12 месяцев после уведомления об устаревании. Мы отправляем письмо каждой команде с активным access token за 90, 30 и 7 дней до прекращения — никаких сюрпризов в продакшене.

Готовы начать разработку?

Частые вопросы

Вопросы, ответы здесь.

Это REST-интерфейс плюс подписанные вебхуки, открывающие голосовые звонки, SMS / MMS, телефонные номера, пользователей и AI-инструменты. Аутентифицируйтесь через bearer access token, обращайтесь к документированным эндпоинтам и запускайтесь за минуты.

REST · вебхуки · SDK

Создавайте на api и запускайтесь в тот же день.

Поддержка 24/7 включена. Перенос номеров от любого оператора по всему миру.

Поддержка 24/760+ странSOC 2 IIКонсоль песочницы
Последнее обновление: май 2026 г.