إنشاء الاتصال والمراسلة والذكاء الاصطناعي على Acepeak API.
نقاط نهاية 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، وافتح Developers → Tokens، وقم بإنشاء رمز حامل جديد. يتم تحديد نطاق الرموز المميزة لكل بيئة (وضع الحماية أو البث المباشر) ويمكن تدويرها من لوحة المعلومات في أي وقت.
تنبيه - احتفظ بالرموز المميزة المباشرة من جانب الخادم. أي شيء يلامس المتصفح يجب أن يمر عبر الواجهة الخلفية لديك.
- 02خطوة
مصادقة
يستخدم كل طلب مصادقة الرمز المميز لحاملها في رأس التفويض.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
- 03خطوة
أرسل طلبك الأول
قم بإجراء مكالمة أو إرسال رسالة نصية قصيرة أو إدراج أرقامك - اختر ما يناسب حالة الاستخدام الخاصة بك. يجب أن تشاهد قائمة JSON بأرقام هاتفك. ومن هناك، يمكنك إجراء المكالمات وإرسال الرسائل القصيرة وإعداد خطافات الويب والبدء في البناء.
curl https://endpoints.acepeak.com/v1/numbers \ -H "Authorization: Bearer $ACEPEAK_TOKEN"
كل القدرة في المنصة يتعرض عبر REST.
المكالمات الصوتية
إجراء المكالمات الصادرة والتحكم في المكالمات الواردة والتحويل والمؤتمر والتسجيل والنسخ. تدفقات عنوان URL للإجابة القابلة للبرمجة، والتقاط DTMF أثناء المكالمة، والبث في الوقت الفعلي.
/v1/calls/v1/conferences/v1/recordingsالرسائل (الرسائل القصيرة ورسائل الوسائط المتعددة)
أرسل واستقبل على US 10DLC، والأرقام المجانية والرموز القصيرة. في اتجاهين، إيصالات التسليم، والامتثال لإلغاء الاشتراك، والرسائل الطويلة المتسلسلة.
/v1/messages/v1/messages/inboundأرقام الهواتف
البحث، والشراء، والميناء، والإفراج. أرقام الهوية الرقمية المحلية والدولية والمجانية في الولايات المتحدة في أكثر من 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أسطح الذكاء الاصطناعي
قم بتشغيل موظف الاستقبال بالذكاء الاصطناعي، واسحب النصوص، واحصل على درجات المشاعر لكل مكالمة أو لكل دردشة.
/v1/ai/receptionist/v1/ai/transcripts/v1/ai/sentimentطرق للمصادقة.
مصادقة رمز الوصول
يوصى به للخدمات الخلفية. يتم إرسال الرمز المميز في كل طلب. يتم تحديد نطاق الرموز المميزة حسب البيئة، وتكون قابلة للتدوير من لوحة المعلومات، وترتبط بدور محدد للوصول الأقل امتيازًا.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
أووث 2.0
للتطبيقات الشريكة وعمليات تكامل السوق. منح رمز التفويض مع PKCE. استخدم هذا عندما يعمل تطبيقك نيابة عن عميل بدلاً من حسابك الخاص.
- رمز التفويض + PKCE
- تحديث الرموز المميزة · 30 يومًا افتراضيًا
- تحديد النطاق لكل عميل
متوقعة وموثقة ولا تصمت أبدا.
حدود المعدل
تقصير: 100 ص / ث لكل رمز وصول. انفجارات تصل إلى 200 ص / ث للنوافذ القصيرة. عند تجاوز ذلك، تقوم المنصة بإرجاع 429 برأس إعادة المحاولة بعد.
العجز
طلبات التحول تدعم Idempotency-Key header. استخدمه في طلبات 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 مستقرة. ترقيات يمكن التنبؤ بها.
يتم تثبيت إصدارات الواجهة في عنوان URL (/v1/). تأتي التغييرات العاجلة خلف إصدار رئيسي جديد. تصل الإضافات غير المتقطعة إلى نفس الإصدار مع ملاحظة الإصدار في سجل تغييرات المطور.
الميزات تبقى حية لمدة 12 شهرا بعد إشعار الإيقاف. نرسل بريدًا إلكترونيًا إلى كل فريق يتضمن رمز وصول نشطًا على 90 و 30 و 7 أيام قبل قطع الإنتاج – لا توجد مفاجآت في الإنتاج.
على استعداد لبدء البناء؟
أسئلة، أجاب.
إنها واجهة REST بالإضافة إلى خطافات الويب الموقعة التي تعرض المكالمات الصوتية والرسائل النصية القصيرة / رسائل الوسائط المتعددة وأرقام الهواتف والمستخدمين وأسطح الذكاء الاصطناعي. قم بالمصادقة باستخدام رمز وصول لحاملها، واضغط على نقاط النهاية الموثقة، واشحن في دقائق.
البناء على واجهة برمجة التطبيقات، السفينة في نفس اليوم.
دعم 24/7 متضمن. الأرقام المنقولة من أي شركة اتصالات في جميع أنحاء العالم.