calling, messaging और AI बनाएँ Acepeak api पर।
REST endpoints, रीयल-टाइम webhooks और first-class SDKs। एक bearer access token से api को प्रमाणित करें और पाँच मिनट से कम में अपना पहला request भेजें।
# 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"}'Quickstart.
- 01चरण
एक access token प्राप्त करें
Acepeak dashboard में साइन इन करें, Developers → Tokens खोलें, और एक नया bearer token बनाएँ। Tokens प्रति environment (sandbox या live) scoped होते हैं और किसी भी समय dashboard से rotatable होते हैं।
ध्यान दें — live tokens को server-side रखें। जो कुछ भी किसी browser को छूता है, उसे आपके backend से होकर जाना चाहिए।
- 02चरण
प्रमाणित करें
हर request Authorization header में bearer-token auth का उपयोग करता है।
Authorization: Bearer YOUR_ACEPEAK_TOKEN
- 03चरण
अपना पहला request भेजें
एक कॉल करें, एक SMS भेजें, या अपने नंबर सूचीबद्ध करें — जो भी आपके use case के अनुकूल हो वह चुनें। आपको अपने phone नंबरों की एक JSON सूची दिखनी चाहिए। वहाँ से, आप कॉल कर सकते हैं, SMS भेज सकते हैं, webhooks सेट कर सकते हैं, और बनाना शुरू कर सकते हैं।
curl https://endpoints.acepeak.com/v1/numbers \ -H "Authorization: Bearer $ACEPEAK_TOKEN"
platform में हर क्षमता REST के ज़रिए उजागर की गई है।
Voice कॉल
outbound कॉल करें, inbound कॉल नियंत्रित करें, transfer, conference, record, transcribe करें। Programmable answer-URL flows, in-call DTMF capture, रीयल-टाइम streaming।
/v1/calls/v1/conferences/v1/recordingsMessaging (SMS और MMS)
US 10DLC, toll-free और short-code नंबरों पर भेजें और प्राप्त करें। दो-तरफ़ा, delivery receipts, opt-out अनुपालन, concatenated लंबे संदेश।
/v1/messages/v1/messages/inboundPhone नंबर
खोजें, खरीदें, पोर्ट करें और रिलीज़ करें। 60+ देशों में Local US, toll-free और अंतरराष्ट्रीय DIDs।
/v1/numbers/v1/numbers/available/v1/numbers/port-ordersUsers और Teams
users को प्रावधान करें, roles असाइन करें, teams प्रबंधित करें, SSO कॉन्फ़िगर करें। आपके IdP के साथ स्वचालित lifecycle प्रबंधन के लिए SCIM 2.0।
/v1/users/v1/teams/v1/ssoWebhooks
आपके endpoint पर कॉल, message और recording events की रीयल-टाइम delivery। HMAC-SHA256 signed, 24h तक exponential backoff के साथ पुनः प्रयास किया गया।
/v1/webhooks/v1/webhooks/{id}/eventsAI सतहें
AI Receptionist को ट्रिगर करें, transcripts खींचें, प्रति कॉल या प्रति chat sentiment scores प्राप्त करें।
/v1/ai/receptionist/v1/ai/transcripts/v1/ai/sentimentतरीके प्रमाणीकरण के।
Access token auth
backend सेवाओं के लिए अनुशंसित। हर request में Bearer token भेजा जाता है। Tokens प्रति environment scoped होते हैं, dashboard से rotate किए जा सकते हैं, और least-privilege एक्सेस के लिए एक विशिष्ट role से जुड़े होते हैं।
Authorization: Bearer YOUR_ACEPEAK_TOKEN
OAuth 2.0
partner ऐप्स और marketplace एकीकरण के लिए। PKCE के साथ Authorization Code grant। इसका उपयोग तब करें जब आपका ऐप आपके अपने खाते के बजाय किसी ग्राहक की ओर से काम करता है।
- Authorization Code + PKCE
- Refresh tokens · 30-दिन डिफ़ॉल्ट
- Per-customer scoping
अनुमानशील, प्रलेखित, और कभी मौन नहीं।
Rate limits
डिफ़ॉल्ट: 100 r/s प्रति access token। तक के bursts 200 r/s छोटी विंडो के लिए। सीमा पार होने पर, platform एक Retry-After header के साथ 429 लौटाता है।
Idempotency
Mutating requests एक का समर्थन करते हैं Idempotency-Key header। इसका उपयोग POST, PUT और DELETE requests पर करें ताकि retries दोहरा शुल्क या दोहरा भेजना न करें।
Error codes
400Bad requestValidation विफल401Unauthorizedअमान्य या गुम access token403ForbiddenToken के पास scope नहीं है404नहीं मिलाResource नहीं मिला409ConflictIdempotency या state बेमेल429Rate limitedधीमे करें — Retry-After प्रदान किया गया5xxServer-sideexponential backoff के साथ पुनः प्रयास करें
रीयल-टाइम events आपके endpoint तक पहुँचाए गए।
call, message और recording events के लिए एक HTTPS endpoint subscribe करें। Webhooks पर HMAC-SHA256 से हस्ताक्षर होते हैं — प्रोसेसिंग से पहले signature सत्यापित करें। विफल deliveries को 24 घंटे तक exponential backoff के साथ पुनः प्रयास किया जाता है। आप dashboard से किसी भी event को replay कर सकते हैं।
{
"id": "evt_01HW3...",
"type": "call.completed",
"created_at": "2026-04-30T10:42:00Z",
"data": {
"call_id": "CA_01HW...",
"duration_sec": 184
}
}First-class libraries, REST से mirror-mapped।
स्थिर URLs। अनुमानशील upgrades।
Interface versions URL में pinned हैं (/v1/). Breaking changes एक नए major version के पीछे शिप होते हैं। Non-breaking जोड़ developer changelog में एक release note के साथ उसी version पर आते हैं।
Features तक लाइव रहते हैं 12 महीने deprecation सूचना के बाद। हम सक्रिय access token वाली हर टीम को ईमेल करते हैं 90, 30 और 7 दिन cutoff से पहले — production में कोई चौंकाने वाली बात नहीं।
बनाना शुरू करने के लिए तैयार हैं?
सवाल, जवाब दिए गए।
यह एक REST interface है, साथ ही signed webhooks जो voice calling, SMS / MMS, phone नंबर, users और AI सतहों को उजागर करते हैं। एक bearer access token से प्रमाणित करें, documented endpoints तक पहुँचें, और मिनटों में शिप करें।
api पर बनाएँ, उसी दिन शिप करें।
24/7 सपोर्ट शामिल। दुनिया भर के किसी भी carrier से नंबर पोर्ट किए गए।