Twórz połączenia, wiadomości i AI na api Acepeak.
Endpointy REST, webhooki w czasie rzeczywistym i pełnoprawne SDK. Uwierzytelnij api tokenem dostępu typu bearer i wyślij pierwsze żądanie w mniej niż pięć minut.
# 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"}'Szybki start.
- 01krok
Uzyskaj token dostępu
Zaloguj się do pulpitu Acepeak, otwórz Developers → Tokens i utwórz nowy token bearer. Tokeny mają zakres przypisany do środowiska (sandbox lub produkcyjne) i można je rotować z pulpitu w dowolnym momencie.
Uwaga — przechowuj tokeny produkcyjne po stronie serwera. Wszystko, co dotyka przeglądarki, powinno przechodzić przez Twój backend.
- 02krok
Uwierzytelnij
Każde żądanie używa uwierzytelniania tokenem bearer w nagłówku Authorization.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
- 03krok
Wyślij pierwsze żądanie
Wykonaj połączenie, wyślij SMS lub wylistuj swoje numery — wybierz to, co pasuje do Twojego przypadku użycia. Powinieneś zobaczyć listę swoich numerów telefonów w formacie JSON. Stamtąd możesz wykonywać połączenia, wysyłać SMS, konfigurować webhooki i zacząć budować.
curl https://endpoints.acepeak.com/v1/numbers \ -H "Authorization: Bearer $ACEPEAK_TOKEN"
Każda możliwość platformy jest udostępniona przez REST.
Połączenia głosowe
Wykonuj połączenia wychodzące, steruj połączeniami przychodzącymi, przekierowuj, prowadź konferencje, nagrywaj, transkrybuj. Programowalne przepływy answer-URL, przechwytywanie DTMF w trakcie połączenia, strumieniowanie w czasie rzeczywistym.
/v1/calls/v1/conferences/v1/recordingsWiadomości (SMS i MMS)
Wysyłaj i odbieraj na amerykańskich numerach 10DLC, bezpłatnych i shortkodach. Dwukierunkowo, potwierdzenia dostarczenia, zgodność z opt-out, łączone długie wiadomości.
/v1/messages/v1/messages/inboundNumery telefonów
Wyszukuj, kupuj, przenoś i zwalniaj. Lokalne amerykańskie, bezpłatne i międzynarodowe numery DID w ponad 60 krajach.
/v1/numbers/v1/numbers/available/v1/numbers/port-ordersUżytkownicy i zespoły
Provisionuj użytkowników, przypisuj role, zarządzaj zespołami, konfiguruj SSO. SCIM 2.0 do automatycznego zarządzania cyklem życia z Twoim IdP.
/v1/users/v1/teams/v1/ssoWebhooki
Dostarczanie w czasie rzeczywistym zdarzeń połączeń, wiadomości i nagrań do Twojego endpointu. Podpisane HMAC-SHA256, ponawiane z wykładniczym backoffem przez 24 h.
/v1/webhooks/v1/webhooks/{id}/eventsFunkcje AI
Uruchamiaj AI Receptionist, pobieraj transkrypcje, odczytuj oceny nastroju per połączenie lub per czat.
/v1/ai/receptionist/v1/ai/transcripts/v1/ai/sentimentSposoby uwierzytelniania.
Uwierzytelnianie tokenem dostępu
Zalecane dla usług backendowych. Token typu Bearer wysyłany w każdym żądaniu. Tokeny mają zakres na środowisko, można je rotować z panelu i są powiązane z konkretną rolą zgodnie z zasadą najmniejszych uprawnień.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
OAuth 2.0
Dla aplikacji partnerskich i integracji z marketplace. Grant Authorization Code z PKCE. Użyj tego, gdy Twoja aplikacja działa w imieniu klienta, a nie Twojego własnego konta.
- Authorization Code + PKCE
- Tokeny odświeżania · domyślnie 30 dni
- Zakres na klienta
Przewidywalne, udokumentowane i nigdy ciche.
Limity zapytań
Domyślnie: 100 r/s na token dostępu. Skoki do 200 r/s w krótkich oknach. Po przekroczeniu platforma zwraca 429 z nagłówkiem Retry-After.
Idempotentność
Żądania modyfikujące obsługują nagłówek Idempotency-Key header. Używaj go w żądaniach POST, PUT i DELETE, aby ponowne próby nie powodowały podwójnego obciążenia ani podwójnej wysyłki.
Kody błędów
400Błędne żądanieWalidacja nie powiodła się401Brak autoryzacjiNieprawidłowy lub brakujący token dostępu403ZabronioneToken nie ma odpowiedniego zakresu404Nie znalezionoNie znaleziono zasobu409KonfliktNiezgodność idempotentności lub stanu429Ograniczono liczbę żądańZwolnij — podano Retry-After5xxPo stronie serweraPonów z wykładniczym backoffem
Zdarzenia w czasie rzeczywistym dostarczane do Twojego endpointu.
Subskrybuj endpoint HTTPS do zdarzeń połączeń, wiadomości i nagrań. Webhooki są podpisywane HMAC-SHA256 — zweryfikuj podpis przed przetworzeniem. Nieudane dostawy są ponawiane z wykładniczym opóźnieniem przez maksymalnie 24 godziny. Każde zdarzenie możesz odtworzyć z panelu.
{
"id": "evt_01HW3...",
"type": "call.completed",
"created_at": "2026-04-30T10:42:00Z",
"data": {
"call_id": "CA_01HW...",
"duration_sec": 184
}
}Pełnoprawne biblioteki, odwzorowane na REST.
Stabilne adresy URL. Przewidywalne aktualizacje.
Wersje interfejsu są przypięte w adresie URL (/v1/). Zmiany niekompatybilne trafiają do nowej wersji głównej. Dodatki niełamiące zgodności pojawiają się w tej samej wersji wraz z notką w changelogu dla deweloperów.
Funkcje pozostają aktywne przez 12 miesięcy po powiadomieniu o wycofaniu. Wysyłamy e-mail do każdego zespołu z aktywnym tokenem dostępu na 90, 30 i 7 dni przed terminem — bez niespodzianek na produkcji.
Gotów, by zacząć budować?
Pytania, z odpowiedziami.
To interfejs REST oraz podpisane webhooki, które udostępniają połączenia głosowe, SMS / MMS, numery telefonów, użytkowników i funkcje AI. Uwierzytelnij się tokenem dostępu typu bearer, odwołaj się do udokumentowanych endpointów i wdróż w kilka minut.
Buduj na api, wdrażaj tego samego dnia.
Wsparcie 24/7 w cenie. Numery przenoszone od dowolnego operatora na świecie.