Створюйте дзвінки, обмін повідомленнями та AI на Acepeak api.
REST-ендпоінти, webhooks у реальному часі та повноцінні SDK. Автентифікуйте api за допомогою bearer-токена доступу та надішліть свій перший запит менш ніж за п’ять хвилин.
# 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, відкрийте Developers → Tokens і створіть новий bearer-токен. Токени мають область дії для кожного середовища (sandbox або live) і можуть ротуватися з панелі будь-коли.
Увага — зберігайте live-токени на стороні сервера. Усе, що стосується браузера, має проходити через ваш бекенд.
- 02крок
Автентифікація
Кожен запит використовує автентифікацію за bearer-токеном у заголовку Authorization.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
- 03крок
Надішліть свій перший запит
Здійсніть дзвінок, надішліть SMS або отримайте список своїх номерів — оберіть те, що підходить вашому сценарію. Ви маєте побачити JSON-список ваших телефонних номерів. Звідти ви можете здійснювати дзвінки, надсилати SMS, налаштовувати webhooks і починати створювати.
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, безкоштовних і коротких кодах. Двосторонній обмін, підтвердження доставки, відповідність вимогам відмови від підписки, склеєні довгі повідомлення.
/v1/messages/v1/messages/inboundТелефонні номери
Шукайте, купуйте, переносьте та звільняйте. Локальні US, безкоштовні та міжнародні DID у понад 60 країнах.
/v1/numbers/v1/numbers/available/v1/numbers/port-ordersКористувачі та команди
Створюйте користувачів, призначайте ролі, керуйте командами, налаштовуйте SSO. SCIM 2.0 для автоматизованого керування життєвим циклом з вашим IdP.
/v1/users/v1/teams/v1/ssoWebhooks
Доставка подій дзвінків, повідомлень і записів на ваш ендпоінт у реальному часі. Підписано HMAC-SHA256, повторні спроби з експоненційною затримкою протягом 24 год.
/v1/webhooks/v1/webhooks/{id}/eventsФункції AI
Запускайте AI Receptionist, підтягуйте транскрипції, отримуйте оцінки тональності для кожного дзвінка чи чату.
/v1/ai/receptionist/v1/ai/transcripts/v1/ai/sentimentСпособи автентифікації.
Автентифікація за токеном доступу
Рекомендовано для бекенд-сервісів. Bearer-токен надсилається в кожному запиті. Токени мають область дії для кожного середовища, ротуються з панелі та прив’язані до конкретної ролі для доступу за принципом найменших привілеїв.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
OAuth 2.0
Для партнерських застосунків та інтеграцій маркетплейсу. Authorization Code grant з PKCE. Використовуйте це, коли ваш застосунок діє від імені клієнта, а не вашого власного облікового запису.
- Authorization Code + PKCE
- Refresh-токени · 30 днів за замовчуванням
- Область дії для кожного клієнта
Передбачувані, задокументовані й ніколи не приховані.
Ліміти запитів
За замовчуванням: 100 r/s на кожен токен доступу. Сплески до 200 r/s на короткі періоди. У разі перевищення платформа повертає 429 із заголовком Retry-After.
Ідемпотентність
Запити, що змінюють дані, підтримують заголовок Idempotency-Key . Використовуйте його в запитах POST, PUT і DELETE, щоб повторні спроби не призводили до подвійного списання чи подвійного надсилання.
Коди помилок
400Неправильний запитВалідація не пройдена401Не авторизованоНедійсний або відсутній токен доступу403ЗабороненоТокен не має потрібної області доступу404Не знайденоРесурс не знайдено409КонфліктНевідповідність ідемпотентності або стану429Перевищено ліміт запитівСповільніться — надано Retry-After5xxНа стороні сервераПовторіть з експоненційною затримкою
Події в реальному часі доставляються на ваш ендпоінт.
Підпишіть HTTPS-ендпоінт на події дзвінків, повідомлень і записів. Webhooks підписані 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-інтерфейс плюс підписані webhooks, що надають доступ до голосових дзвінків, SMS / MMS, телефонних номерів, користувачів і функцій AI. Автентифікуйтеся за допомогою bearer-токена доступу, звертайтеся до задокументованих ендпоінтів і запускайтеся за хвилини.
Створюйте на api, випускайте того ж дня.
24/7 підтримка включена. Номери переносяться від будь-якого оператора у світі.