कॉलिंग, मैसेजिंग और AI बनाएं Acepeak एपीआई पर।
REST एंडपॉइंट, रीयल-टाइम वेबहुक और प्रथम श्रेणी SDK। एपीआई को बियरर एक्सेस टोकन के साथ प्रमाणित करें और अपना पहला अनुरोध पांच मिनट से कम समय में भेजें।
# 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 के माध्यम से उजागर होता है।
ध्वनि कॉल
आउटबाउंड कॉल्स रखें, इनबाउंड कॉल्स को नियंत्रित करें, ट्रांसफर करें, कॉन्फ़्रेंस करें, रिकॉर्ड करें, ट्रांसक्राइब करें। प्रोग्रामयोग्य उत्तर-यूआरएल प्रवाह, इन-कॉल DTMF कैप्चर, रीयल-टाइम स्ट्रीमिंग।
/v1/calls/v1/conferences/v1/recordingsमैसेजिंग (SMS और MMS)
यूएस 10DLC, टोल-फ़्री और शॉर्ट-कोड नंबरों पर भेजें और प्राप्त करें। दोतरफा, डिलीवरी रसीदें, ऑप्ट-आउट अनुपालन, सिलसिलेवार लंबे संदेश।
/v1/messages/v1/messages/inboundदूरभाष संख्या
खोजें, खरीदें, पोर्ट करें और रिलीज़ करें। स्थानीय यूएस, टोल-फ़्री, और 60+ देशों में अंतर्राष्ट्रीय DIDs।
/v1/numbers/v1/numbers/available/v1/numbers/port-ordersउपयोगकर्ता एवं टीमें
उपयोगकर्ताओं को प्रावधानित करें, भूमिकाएँ निर्दिष्ट करें, टीमों का प्रबंधन करें, SSO कॉन्फ़िगर करें। आपके आईडीपी के साथ स्वचालित जीवनचक्र प्रबंधन के लिए एससीआईएम 2.0।
/v1/users/v1/teams/v1/ssoवेबहुक
आपके एंडपॉइंट पर कॉल, संदेश और रिकॉर्डिंग घटनाओं की वास्तविक समय पर डिलीवरी। HMAC-SHA256 पर हस्ताक्षर किए गए, 24 घंटों के लिए घातीय बैकऑफ़ के साथ पुनः प्रयास किया गया।
/v1/webhooks/v1/webhooks/{id}/eventsएआई सतहें
एआई रिसेप्शनिस्ट को ट्रिगर करें, ट्रांसक्रिप्ट खींचें, प्रति कॉल या प्रति चैट भावना स्कोर प्राप्त करें।
/v1/ai/receptionist/v1/ai/transcripts/v1/ai/sentimentतौर तरीकों प्रमाणित करना.
एक्सेस टोकन प्रमाणीकरण
बैकएंड सेवाओं के लिए अनुशंसित. प्रत्येक अनुरोध में बियरर टोकन भेजा जाता है। टोकन को प्रत्येक वातावरण के अनुसार दायरे में रखा जाता है, डैशबोर्ड से घुमाया जा सकता है, और कम से कम विशेषाधिकार प्राप्त पहुंच के लिए एक विशिष्ट भूमिका से बांधा जाता है।
Authorization: Bearer YOUR_ACEPEAK_TOKEN
ओऑथ 2.0
पार्टनर ऐप्स और मार्केटप्लेस एकीकरण के लिए। पीकेसीई के साथ प्राधिकरण कोड अनुदान। इसका उपयोग तब करें जब आपका ऐप आपके खाते के बजाय किसी ग्राहक की ओर से कार्य करता हो।
- प्राधिकरण कोड + पीकेसीई
- टोकन ताज़ा करें · 30 दिन का डिफ़ॉल्ट
- प्रति ग्राहक दायरा
पूर्वानुमानित, प्रलेखित, और कभी चुप नहीं रहते.
दर सीमा
गलती करना: 100 आर/एस प्रति एक्सेस टोकन. तक फट जाता है 200 आर/एस छोटी खिड़कियों के लिए. अधिक होने पर, प्लेटफ़ॉर्म रिट्री-आफ्टर हेडर के साथ 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
}
}प्रथम श्रेणी पुस्तकालय, REST के लिए मिरर-मैप किया गया।
स्थिर यूआरएल. पूर्वानुमानित उन्नयन.
इंटरफ़ेस संस्करण URL में पिन किए गए हैं (/v1/). ब्रेकिंग परिवर्तन एक नए प्रमुख संस्करण के पीछे भेजे जाते हैं। डेवलपर चेंजलॉग में रिलीज़ नोट के साथ नॉन-ब्रेकिंग एडिशन उसी संस्करण पर आते हैं।
सुविधाएँ लाइव रहती हैं 12 महीने पदावनत नोटिस के बाद. हम प्रत्येक टीम को एक सक्रिय एक्सेस टोकन के साथ ईमेल करते हैं 90, 30, और 7 दिन कटऑफ से पहले - उत्पादन में कोई आश्चर्य नहीं।
निर्माण शुरू करने के लिए तैयार हैं?
प्रश्न, उत्तर दिया.
यह एक REST इंटरफ़ेस और हस्ताक्षरित वेबहुक है जो वॉयस कॉलिंग, SMS / MMS, फ़ोन नंबर, उपयोगकर्ताओं और AI सतहों को उजागर करता है। बियरर एक्सेस टोकन के साथ प्रमाणित करें, दस्तावेज़ीकृत अंतिम बिंदु पर पहुंचें, और मिनटों में शिप करें।
प्रत्येक अनुरोध प्राधिकरण शीर्षलेख में एक बियरर एक्सेस टोकन का उपयोग करता है। टोकन प्रति वातावरण (सैंडबॉक्स या लाइव) के दायरे में होते हैं, डेवलपर डैशबोर्ड से घूमने योग्य होते हैं, और कम से कम-विशेषाधिकार प्राप्त पहुंच के लिए एक भूमिका से बंधे होते हैं। PKCE के साथ OAuth 2.0 भी पार्टनर ऐप्स के लिए समर्थित है।
हाँ। प्रथम श्रेणी के पुस्तकालय नोड, पायथन, पीएचपी, गो और रूबी के लिए भेजे जाते हैं। प्रत्येक SDK REST सतह को एक-से-एक प्रतिबिंबित करता है और जहां लागू हो, टाइपस्क्रिप्ट प्रकारों के साथ प्रकाशित किया जाता है, इसलिए आपका IDE समापन बिंदुओं और ईवेंट पेलोड को स्वत: पूर्ण करता है।
कॉल, संदेश और रिकॉर्डिंग ईवेंट के लिए HTTPS एंडपॉइंट की सदस्यता लें। पेलोड HMAC-SHA256 पर हस्ताक्षरित हैं - प्रसंस्करण से पहले हस्ताक्षर सत्यापित करें। विफल डिलीवरी को 24 घंटे तक घातीय बैकऑफ़ के साथ पुनः प्रयास किया जाता है, और किसी भी घटना को डैशबोर्ड से दोबारा चलाया जा सकता है।
डिफ़ॉल्ट 100 अनुरोध प्रति सेकंड प्रति एक्सेस टोकन, छोटी विंडो के लिए 200 आर/एस तक बर्स्ट के साथ। अधिक होने पर, प्लेटफ़ॉर्म रिट्री-आफ्टर हेडर के साथ 429 लौटाता है। परिवर्तनशील समापनबिंदु एक Idempotency-कुंजी स्वीकार करते हैं ताकि पुनः प्रयास दोबारा न भेजें।
एपीआई पर निर्माण करें, उसी दिन भेजो.
24/7 समर्थन शामिल है। दुनिया भर में किसी भी वाहक से पोर्ट किए गए नंबर।