Создавайте звонки, обмен сообщениями и искусственный интеллект на API Acepeak.
Конечные точки REST, веб-перехватчики реального времени и первоклассные SDK. Аутентифицируйте API с помощью токена доступа на предъявителя и отправьте свой первый запрос менее чем за пять минут.
# 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"}'Быстрый старт.
- 01шаг
Получить токен доступа
Войдите в панель управления Acepeak, откройте «Разработчики» → «Токены» и создайте новый токен на предъявителя. Токены имеют область действия для каждой среды (песочница или активная среда) и могут меняться с панели управления в любое время.
Будьте внимательны — храните активные токены на стороне сервера. Все, что касается браузера, должно проходить через ваш бэкэнд.
- 02шаг
Аутентификация
Каждый запрос использует аутентификацию на основе токена носителя в заголовке авторизации.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
- 03шаг
Отправьте свой первый запрос
Позвоните, отправьте SMS или перечислите свои номера — выберите тот, который подходит вашему варианту использования. Вы должны увидеть список ваших телефонных номеров в формате JSON. Отсюда вы можете совершать звонки, отправлять SMS, настраивать веб-перехватчики и приступать к созданию.
curl https://endpoints.acepeak.com/v1/numbers \ -H "Authorization: Bearer $ACEPEAK_TOKEN"
Все возможности платформы предоставляется через REST.
Голосовые вызовы
Размещайте исходящие вызовы, управляйте входящими вызовами, переводите, проводите конференцию, записывайте, расшифровывайте. Программируемые потоки URL-адресов ответа, захват DTMF во время вызова, потоковая передача в реальном времени.
/v1/calls/v1/conferences/v1/recordingsСообщения (SMS и MMS)
Отправляйте и получайте сообщения по номерам US 10DLC, по бесплатному номеру и по номерам с коротким кодом. Двусторонняя рассылка, квитанции о доставке, отказ от рассылки, объединенные длинные сообщения.
/v1/messages/v1/messages/inboundНомера телефонов
Ищите, покупайте, портируйте и выпускайте. Местные американские, бесплатные и международные номера DID в более чем 60 странах.
/v1/numbers/v1/numbers/available/v1/numbers/port-ordersПользователи и команды
Предоставляйте пользователей, назначайте роли, управляйте командами, настраивайте единый вход. SCIM 2.0 для автоматического управления жизненным циклом с помощью вашего IdP.
/v1/users/v1/teams/v1/ssoВебхуки
Доставка вызовов, сообщений и событий записи в режиме реального времени на вашу конечную точку. Подписан HMAC-SHA256, повторена попытка с экспоненциальной задержкой в течение 24 часов.
/v1/webhooks/v1/webhooks/{id}/eventsИИ-поверхности
Запускайте секретаршу с искусственным интеллектом, получайте стенограммы, получайте оценки настроений для каждого звонка или чата.
/v1/ai/receptionist/v1/ai/transcripts/v1/ai/sentimentСпособы для аутентификации.
Авторизация по токену доступа
Рекомендуется для серверных служб. Токен носителя отправляется в каждом запросе. Токены распределяются по среде, могут меняться с панели управления и привязаны к определенной роли для доступа с наименьшими привилегиями.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
ОАутентификация 2.0
Для партнерских приложений и интеграции с торговой площадкой. Предоставление кода авторизации с помощью PKCE. Используйте это, когда ваше приложение действует от имени клиента, а не от вашей собственной учетной записи.
- Код авторизации + PKCE
- Обновление токенов · 30-дневный срок по умолчанию
- Определение объема по каждому клиенту
Предсказуемый, документированный, и никогда не молчит.
Ограничения ставок
По умолчанию: 100 р/с за токен доступа. Вспыхивает до 200 р/с для коротких окон. При превышении платформа возвращает 429 с заголовком Retry-After.
Идемпотентность
Мутирующие запросы поддерживают Idempotency-Key заголовок. Используйте его для запросов POST, PUT и DELETE, чтобы при повторных попытках не требовалась двойная оплата или двойная отправка.
Коды ошибок
400Неверный запросПроверка не удалась401НесанкционированныйНеверный или отсутствующий токен доступа403ЗапрещенныйТокен не имеет области действия404Не найденоРесурс не найден409КонфликтИдемпотентность или несовпадение состояний429Скорость ограниченаЗамедлить — предусмотрена повторная попытка5xxСерверная частьПовторить попытку с экспоненциальной задержкой
События в реальном времени доставлено в вашу конечную точку.
Подпишитесь на конечную точку HTTPS для звонков, сообщений и записи событий. Вебхуки подписываются с помощью HMAC-SHA256 — проверьте подпись перед обработкой. Неудачные поставки повторяются с экспоненциальной задержкой на срок до 24 часов. Вы можете воспроизвести любое событие с панели управления.
{
"id": "evt_01HW3...",
"type": "call.completed",
"created_at": "2026-04-30T10:42:00Z",
"data": {
"call_id": "CA_01HW...",
"duration_sec": 184
}
}Первоклассные библиотеки, зеркально отображается на REST.
Стабильные URL-адреса. Предсказуемые обновления.
Версии интерфейса закреплены в URL. (/v1/). Серьезные изменения сопровождают новую основную версию. Некритичные дополнения появляются в той же версии с примечанием к выпуску в журнале изменений разработчика.
Функции остаются в силе 12 месяцев после уведомления об устаревании. Мы отправляем электронное письмо каждой команде с активным токеном доступа по адресу 90, 30 и 7 дней до отсечки — никаких сюрпризов в производстве.
Готовы начать строительство?
Вопросы, ответил.
Это интерфейс REST плюс подписанные веб-перехватчики, которые предоставляют доступ к голосовым вызовам, SMS/MMS, телефонным номерам, пользователям и поверхностям искусственного интеллекта. Выполните аутентификацию с помощью токена доступа на предъявителя, подключитесь к задокументированным конечным точкам и отправьте сообщение за считанные минуты.
Создавать на основе API, отправка в тот же день.
Круглосуточная поддержка включена. Номера перенесены от любого оператора мира.