الحصول على مفتاح Ody API الخاص بك
يمكنك إنشاء مفاتيح API في الإعدادات ← واجهة برمجة تطبيقات المطور: قم بتسمية المفتاح، اختر نطاقاته، اختر مباشر أو اختبار، انقر فوق إنشاء مفتاح، وانسخ السر من اللافتة التي تظهر مرة واحدة.
قبل أن تبدأ
- يجب أن تكون مسؤولًا أو مالكًا لمساحة العمل لإنشاء المفاتيح أو إلغائها.
- تعمل المفاتيح بصلاحيات العضو الذي أنشأها — لا يمكنها أبدًا فعل أكثر مما يمكن لذلك الشخص فعله في التطبيق.
خطوة بخطوة
انقر على الإعدادات في الشريط الجانبي، ثم واجهة برمجة تطبيقات المطور. (على هاتفك: المزيد ← الإعدادات ← واجهة برمجة تطبيقات المطور.)
في نموذج الإنشاء، أدخل اسمًا للمفتاح — على سبيل المثال "Zapier" أو "خادم الإنتاج" — حتى تتمكن من تمييز المفاتيح لاحقًا.
اختر نطاقات المفتاح باستخدام الشرائح الموجودة أسفل حقل الاسم. يتم تحديد جميع العشرة مسبقًا، مما يجعل المفتاح ذا وصول كامل؛ قم بإلغاء تحديد الشرائح لتضييق النطاق. النطاقات المتاحة هي قراءة جهات الاتصال، إدارة جهات الاتصال، قراءة المحادثات، تحديث المحادثات، إرسال الرسائل، قراءة الأرقام، إدارة الويب هوكس، شراء الأرقام و 10DLC، إجراء مكالمات الذكاء الاصطناعي، و إدارة وكيل الذكاء الاصطناعي.
ضمن نوع المفتاح، اختر مباشر أو اختبار. تبدأ المفاتيح المباشرة بـ
ody_live_وتنفذ كل شيء بشكل حقيقي. تبدأ مفاتيح الاختبار بـody_test_وتقرأ بيانات حقيقية، ولكن يتم تسجيل إرسال الرسائل كمحاكاة ولا يتم إرسالها أبدًا — وهي مثالية للبناء والتكامل المستمر (CI). انظر البناء بأمان باستخدام وضع الاختبار.انقر على إنشاء مفتاح.
انسخ المفتاح من اللافتة الخضراء — "انسخ مفتاحك الجديد الآن — لن تراه مرة أخرى." يخزن Ody تجزئة فقط، لذا يتم عرض النص العادي مرة واحدة فقط.
قم بتخزين المفتاح ككلمة مرور — في مدير الأسرار أو متغير بيئة، وليس أبدًا في كود من جانب العميل أو مستند مشترك.
إدارة المفاتيح الموجودة
أسفل نموذج الإنشاء، يتم سرد كل مفتاح باسمه، وتلميح مقنع (ody_live_…WXYZ أو ody_test_…WXYZ)، وشارة اختبار لمفاتيح الاختبار، ونطاقاته كشرائح ("وصول كامل" عندما يكون غير مقيد)، ومتى تم استخدامه آخر مرة. انقر على إلغاء لتعطيل المفتاح فورًا — تتوقف المفاتيح الملغاة عن المصادقة على الفور ولا يمكن استعادتها.
مقالات ذات صلة
- نظرة عامة على API والمصادقة
- البناء بأمان باستخدام وضع الاختبار
- ربط أدوات الذكاء الاصطناعي بـ MCP
- حدود معدل API وأفضل الممارسات
الأسئلة الشائعة
لقد فقدت مفتاح API الخاص بي — هل يمكنني رؤيته مرة أخرى؟
لا. يتم عرض المفتاح الكامل مرة واحدة فقط، عند الإنشاء. قم بإلغاء المفتاح المفقود وأنشئ مفتاحًا جديدًا.
ما الفرق بين مفتاح مباشر ومفتاح اختبار؟
المفاتيح المباشرة (ody_live_…) ترسل رسائل نصية حقيقية. مفاتيح الاختبار (ody_test_…) تتصرف بشكل متطابق ولكن إرسال الرسائل يكون محاكاة — يتم تسجيلها في المحادثة، ولا يتم إرسالها أبدًا.
من يمكنه إنشاء مفاتيح API؟
مسؤولو ومالكو مساحة العمل. تعمل المفاتيح بصلاحيات العضو الذي أنشأها.
ما هي الخطط التي تتضمن API؟
جميعها — يتم تضمين API و MCP بدءًا من خطة Starter.