통화, 메시징, AI 구축 Acepeak API에서.
REST 엔드포인트, 실시간 웹훅 및 최고 수준의 SDK. 전달자 액세스 토큰으로 API를 인증하고 5분 이내에 첫 번째 요청을 보냅니다.
# 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-Token 인증을 사용합니다.
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)
미국 10DLC, 무료 및 단축 코드 번호로 보내고 받습니다. 양방향, 배달 확인, 옵트아웃 준수, 연결된 긴 메시지.
/v1/messages/v1/messages/inbound전화번호
검색, 구매, 포팅, 출시가 가능합니다. 60개 이상 국가의 미국 현지, 무료 및 국제 DID입니다.
/v1/numbers/v1/numbers/available/v1/numbers/port-orders사용자 및 팀
사용자 프로비저닝, 역할 할당, 팀 관리, SSO 구성이 가능합니다. IdP를 통한 자동화된 수명주기 관리를 위한 SCIM 2.0.
/v1/users/v1/teams/v1/sso웹훅
통화, 메시지, 녹음 이벤트를 엔드포인트에 실시간으로 전달합니다. HMAC-SHA256이 서명되었으며 24시간 동안 지수 백오프로 재시도되었습니다.
/v1/webhooks/v1/webhooks/{id}/eventsAI 표면
AI 접수원을 트리거하고, 기록을 가져오고, 통화당 또는 채팅당 감정 점수를 가져옵니다.
/v1/ai/receptionist/v1/ai/transcripts/v1/ai/sentiment방법 인증하기.
액세스 토큰 인증
백엔드 서비스에 권장됩니다. 모든 요청에서 전달자 토큰이 전송됩니다. 토큰은 환경별로 범위가 지정되고 대시보드에서 순환 가능하며 최소 권한 액세스를 위해 특정 역할에 연결됩니다.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
OAuth 2.0
파트너 앱 및 마켓플레이스 통합용. PKCE를 통한 인증 코드 부여. 앱이 자신의 계정이 아닌 고객을 대신하여 작동하는 경우 이를 사용하세요.
- 인증 코드 + PKCE
- 새로 고침 토큰 · 기본값은 30일입니다.
- 고객별 범위 지정
예측 가능하고 문서화되어 있으며 그리고 결코 침묵하지 않습니다.
비율 제한
기본: 100r/초 액세스 토큰당. 최대 버스트 200r/초 짧은 창문용. 초과되면 플랫폼은 Retry-After 헤더와 함께 429를 반환합니다.
멱등성
돌연변이 요청은 다음을 지원합니다. 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
}
}안정적인 URL. 예측 가능한 업그레이드.
인터페이스 버전은 URL에 고정되어 있습니다. (/v1/). 주요 변경 사항은 새로운 주요 버전 뒤에 제공됩니다. 주요 추가 사항은 개발자 변경 로그의 릴리스 노트와 함께 동일한 버전에 제공됩니다.
기능은 다음 기간 동안 유지됩니다. 12개월 지원 중단 공지 이후. 우리는 다음 주소로 활성 액세스 토큰을 모든 팀에 이메일로 보냅니다. 90일, 30일, 7일 컷오프 전 — 생산에는 놀라운 일이 없습니다.
질문, 대답했다.
음성 통화, SMS/MMS, 전화번호, 사용자 및 AI 표면을 노출하는 REST 인터페이스와 서명된 웹후크입니다. 전달자 액세스 토큰으로 인증하고, 문서화된 엔드포인트에 도달하고, 몇 분 안에 배송됩니다.
API를 기반으로 구축하고, 당일 배송.
연중무휴 지원이 포함됩니다. 전 세계 모든 이동통신사에서 번호가 이전됩니다.