المطوّرون

ابنِ الاتصال، والمراسلة، والذكاء الاصطناعي AI على Acepeak api.

نقاط نهاية REST، وWebhooks فورية، وSDKs من الدرجة الأولى. صادِق على api برمز وصول من نوع bearer وأرسل طلبك الأول في أقل من خمس دقائق.

احصل على رمز وصول·عرض الأسعار

place-call.sh

# 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، وأنشئ رمز bearer جديداً. تُحدَّد نطاقات الرموز لكل بيئة (sandbox أو live) وقابلة للتدوير من لوحة المعلومات في أي وقت.
انتبه — احتفظ برموز live من جهة الخادم. أي شيء يلامس المتصفح يجب أن يمرّ عبر الواجهة الخلفية الخاصة بك.
02خطوة
صادِق
يستخدم كل طلب مصادقة برمز bearer في ترويسة Authorization.
```
Authorization: Bearer YOUR_ACEPEAK_TOKEN
```
03خطوة
أرسل طلبك الأول
أجرِ مكالمة، أو أرسل SMS، أو اعرض أرقامك — اختر ما يناسب حالة استخدامك. ينبغي أن ترى قائمة JSON بأرقام هاتفك. من هناك، يمكنك إجراء المكالمات، وإرسال SMS، وإعداد Webhooks، والبدء في البناء.
```
curl https://endpoints.acepeak.com/v1/numbers \
  -H "Authorization: Bearer $ACEPEAK_TOKEN"
```

ما يمكنك بناؤه

كل قدرة في المنصة مُتاحة عبر REST.

المكالمات الصوتية

أجرِ مكالمات صادرة، وتحكّم في المكالمات الواردة، وحوّل، وأنشئ مؤتمرات، وسجّل، وفرّغ نصياً. تدفّقات answer-URL قابلة للبرمجة، والتقاط DTMF أثناء المكالمة، والبثّ الفوري.

/v1/calls/v1/conferences/v1/recordings

المراسلة (SMS وMMS)

أرسل واستقبل على أرقام 10DLC الأمريكية، والمجانية، والرموز القصيرة. ثنائية الاتجاه، وإيصالات التسليم، وامتثال إلغاء الاشتراك، والرسائل الطويلة المتسلسلة.

/v1/messages/v1/messages/inbound

أرقام الهاتف

ابحث، واشترِ، وانقل، وحرّر. أرقام DIDs محلية أمريكية، ومجانية، ودولية عبر أكثر من 60 دولة.

/v1/numbers/v1/numbers/available/v1/numbers/port-orders

المستخدمون والفِرق

هيّئ المستخدمين، وعيّن الأدوار، وأدر الفرق، واضبط SSO. SCIM 2.0 لإدارة دورة الحياة الآلية مع IdP الخاص بك.

/v1/users/v1/teams/v1/sso

Webhooks

تسليم فوري لأحداث المكالمات، والرسائل، والتسجيلات إلى نقطة النهاية الخاصة بك. موقّعة بـ HMAC-SHA256، وتُعاد المحاولة بتراجع أُسّي لمدة 24 ساعة.

/v1/webhooks/v1/webhooks/{id}/events

واجهات AI

أطلق AI Receptionist، واسحب التفريغات النصية، واجلب درجات المشاعر لكل مكالمة أو لكل محادثة.

/v1/ai/receptionist/v1/ai/transcripts/v1/ai/sentiment

المصادقة

طرق للمصادقة.

مصادقة برمز الوصول

موصى به للخدمات الخلفية. يُرسَل رمز bearer في كل طلب. تُحدَّد نطاقات الرموز لكل بيئة، وقابلة للتدوير من لوحة المعلومات، ومرتبطة بدور محدد لوصول الحد الأدنى من الامتيازات.

Authorization: Bearer YOUR_ACEPEAK_TOKEN

OAuth 2.0

لتطبيقات الشركاء وتكاملات المتجر. منح Authorization Code مع PKCE. استخدم هذا عندما يعمل تطبيقك نيابةً عن عميل بدلاً من حسابك الخاص.

Authorization Code + PKCE
رموز التحديث · 30 يوماً افتراضياً
تحديد النطاق لكل عميل

حدود المعدّل والأخطاء

متوقّعة، وموثّقة، وغير صامتة أبداً.

حدود المعدّل

الافتراضي: 100 r/s لكل رمز وصول. دفعات تصل إلى 200 r/s لنوافذ قصيرة. عند التجاوز، تُرجِع المنصة 429 مع ترويسة Retry-After.

الخصوصية التكرارية

تدعم الطلبات المُعدِّلة ترويسة Idempotency-Key . استخدمها في طلبات POST وPUT وDELETE بحيث لا تؤدي إعادة المحاولة إلى محاسبة مزدوجة أو إرسال مزدوج.

رموز الأخطاء

400طلب غير صالحفشل التحقق
401غير مصرّحرمز وصول غير صالح أو مفقود
403محظورالرمز لا يملك النطاق
404غير موجودالمورد غير موجود
409تعارضعدم تطابق في الخصوصية التكرارية أو الحالة
429محدود المعدّلخفّف السرعة — تم توفير Retry-After
5xxمن جهة الخادمأعد المحاولة بتراجع أُسّي

Webhooks

أحداث فورية تُسلَّم إلى نقطة النهاية الخاصة بك.

اشترك بنقطة نهاية HTTPS في أحداث المكالمات، والرسائل، والتسجيلات. تُوقَّع Webhooks بـ HMAC-SHA256 — تحقّق من التوقيع قبل المعالجة. تُعاد محاولة عمليات التسليم الفاشلة بتراجع أُسّي لمدة تصل إلى 24 ساعة. يمكنك إعادة تشغيل أي حدث من لوحة المعلومات.

POST · /your-webhookSigned

{
  "id": "evt_01HW3...",
  "type": "call.completed",
  "created_at": "2026-04-30T10:42:00Z",
  "data": {
    "call_id": "CA_01HW...",
    "duration_sec": 184
  }
}

موقّعة بـ HMAC-SHA256 · آمنة لإعادة التشغيل

إعادات محاولة بتراجع أُسّي لمدة 24 ساعة

أعد تشغيل أي حدث من لوحة المعلومات

تصفية حسب نوع الحدث · لكل نقطة نهاية

SDKs

مكتبات من الدرجة الأولى، مُطابَقة لـ REST.

GitHub·OpenAPI 3.1

Node.jsnpm install @acepeak/sdkتثبيت

Pythonpip install acepeakتثبيت

PHPcomposer require acepeak/sdkتثبيت

Gogo get github.com/acepeak/acepeak-goتثبيت

Rubygem install acepeakتثبيت

مرخّصة بـ MIT · وتيرة إصدار مطابقة للمنصةPostman →

إدارة الإصدارات

روابط مستقرة. ترقيات متوقّعة.

إصدارات الواجهة مثبّتة في الرابط (/v1/). تأتي التغييرات الكاسرة خلف إصدار رئيسي جديد. تصل الإضافات غير الكاسرة على الإصدار نفسه مع ملاحظة إصدار في سجل تغييرات المطوّرين.

سياسة الإيقاف

تبقى الميزات نشطة لمدة 12 شهراً بعد إشعار الإيقاف. نرسل بريداً إلكترونياً إلى كل فريق يملك رمز وصول نشطاً عند 90 و30 و7 أيام قبل الموعد النهائي — بلا مفاجآت في الإنتاج.

هل أنت مستعد لبدء البناء؟

تواصل معنا عرض الأسعار

الأسئلة الشائعة

أسئلة، مُجابة.

ما هو Acepeak api؟

إنه واجهة REST إضافة إلى Webhooks موقّعة تُتيح الاتصال الصوتي، وSMS / MMS، وأرقام الهاتف، والمستخدمين، وواجهات AI. صادِق برمز وصول من نوع bearer، واستدعِ نقاط النهاية الموثّقة، وانطلق في دقائق.

كيف أصادِق؟

هل تتوفّر SDKs مُكتوبة الأنواع؟

كيف تعمل Webhooks؟

ما هي حدود المعدّل؟

REST · webhooks · SDKs

ابنِ على api، وانطلق في اليوم نفسه.

دعم 24/7 مشمول. أرقام مُنقولة من أي مشغّل حول العالم.

devs.acepeak.com·github.com/acepeak·devs@acepeak.com

تواصل معنا عرض الأسعار

دعم 24/7أكثر من 60 دولةSOC 2 IIوحدة تحكم Sandbox

آخر تحديث: مايو 2026

تواصل معنا عرض الأسعار