واجهة برمجة تطبيقات المطور (API)
مفاتيح API، واجهة REST API العامة، وخادم MCP لتكاملات الذكاء الاصطناعي.
الحصول على مفتاح Ody API الخاص بك
أنشئ مفاتيح Ody API وحدد نطاقها وقم بإلغائها من **الإعدادات** ← **واجهة برمجة تطبيقات المطور**. اختر وضع **مباشر** أو **اختبار** — يتم عرض مفتاحك مرة واحدة فقط، لذا انسخه فورًا.
نظرة عامة على API والمصادقة
استدعِ Ody REST API على api.ody.co باستخدام مفتاح Bearer: جهات الاتصال، المحادثات، الرسائل، الأرقام و10DLC، مكالمات الذكاء الاصطناعي، وكيلك، والخطافات الشبكية (webhooks).
ربط أدوات الذكاء الاصطناعي بـ MCP
أضف Ody كخادم MCP حتى تتمكن ChatGPT و Claude و Cursor من إدارة صندوق الوارد الخاص بك، وإرسال الرسائل النصية، وشراء الأرقام، وإجراء مكالمات الذكاء الاصطناعي، وإدارة وكيل الذكاء الاصطناعي الخاص بك.
شراء الأرقام وتسجيل الرسائل النصية عبر الـ API
ابحث واشترِ أرقام هواتف وسجل 10DLC للرسائل النصية عبر Ody API أو MCP — بنفس الفواتير والبوابات والحساب كما في التطبيق.
إجراء مكالمات الذكاء الاصطناعي وإدارة Astra عبر الـ API
اجعل Astra تجري مكالمات صادرة باستخدام POST /calls، وقم بتكوين ونشر وكيل الذكاء الاصطناعي الخاص بك، ووجّه الأرقام إليه — عبر Ody REST API أو أدوات MCP.
حدود معدل استدعاءات API وأفضل الممارسات
يحصل كل مفتاح API من Ody على 600 طلب في الدقيقة. اقرأ رؤوس RateLimit، وتراجع عند استجابات 429، واتبع أفضل ممارسات أمان المفاتيح هذه.
استقبال الويب هوكس والتحقق من التوقيعات
سجّل نقاط نهاية الويب هوكس عبر HTTPS من خلال واجهة برمجة تطبيقات Ody، واشترك في الأحداث مثل `message.received`، وتحقق من التسليمات الموقعة باستخدام سرك `whsec_`.
الإنشاء بأمان باستخدام وضع الاختبار
أنشئ مفتاح API من نوع ody_test_ للإنشاء باستخدام بيانات مساحة العمل الحقيقية بينما تتم محاكاة عمليات الإرسال وشراء الأرقام ومكالمات الذكاء الاصطناعي وطلبات 10DLC.
الترقيم، الثباتية، ومعالجة الأخطاء
تصفح قوائم Ody API باستخدام المؤشرات، أعد محاولات الإرسال بأمان باستخدام رأس Idempotency-Key، وتعامل مع غلاف الخطأ الموحد ومعرفات الطلبات.
دليل البدء السريع لـ SDK: TypeScript و Python
ابدأ باستخدام حزم Ody SDK لـ TypeScript و Python — أرسل الرسائل، اشترِ الأرقام، أجرِ مكالمات الذكاء الاصطناعي، أدر وكيلك، قم بالتقسيم، وتحقق من الويب هوكس.