Створюйте дзвінки, обмін повідомленнями та ШІ на 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Користувачі та команди
Надання користувачів, призначення ролей, керування командами, налаштування SSO. SCIM 2.0 для автоматизованого керування життєвим циклом за допомогою вашого IdP.
/v1/users/v1/teams/v1/ssoВеб-хуки
Доставка викликів, повідомлень і подій запису в реальному часі на вашу кінцеву точку. Підписано HMAC-SHA256, повторна спроба з експоненційною відстрочкою протягом 24 годин.
/v1/webhooks/v1/webhooks/{id}/eventsШІ поверхні
Запустіть AI Receptionist, отримайте стенограми, отримайте оцінки настроїв за дзвінок або чат.
/v1/ai/receptionist/v1/ai/transcripts/v1/ai/sentimentспособи автентифікувати.
Аутентифікація маркера доступу
Рекомендовано для серверних служб. Маркер носія, який надсилається в кожному запиті. Токени розподіляються на середовище, їх можна обертати на інформаційній панелі та прив’язувати до певної ролі для доступу з найменшими привілеями.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
OAuth 2.0
Для партнерських додатків і інтеграції з Marketplace. Надання коду авторизації за допомогою PKCE. Використовуйте це, коли ваша програма діє від імені клієнта, а не від вашого власного облікового запису.
- Код авторизації + PKCE
- Оновити маркери · 30 днів за замовчуванням
- Огляд для кожного клієнта
Передбачуваний, задокументований, і ніколи не мовчить.
Обмеження ставок
За замовчуванням: 100 об/с за маркер доступу. Розривається до 200 об/с для коротких вікон. У разі перевищення платформа повертає 429 із заголовком Retry-After.
Ідемпотентність
Запити на зміну підтримують an Idempotency-Key заголовок. Використовуйте його для запитів POST, PUT і DELETE, щоб повторні спроби не призводили до подвійної оплати або подвійного надсилання.
Коди помилок
400Поганий запитПомилка перевірки401НесанкціонованийНедійсний або відсутній маркер доступу403ЗабороненоМаркер не має області дії404Не знайденоРесурс не знайдено409КонфліктІдемпотентність або невідповідність стану429Тариф обмеженийУповільнення — надається Retry-After5xxНа стороні сервераПовторіть спробу з експоненційною відстрочкою
Події в реальному часі доставлено до вашої кінцевої точки.
Підпишіться на кінцеву точку 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, відправити в той же день.
Підтримка 24/7 включена. Номери перенесені з будь-якого оператора по всьому світу.