الإنشاء بأمان باستخدام وضع الاختبار

تتصرف مفاتيح API لوضع الاختبار (ody_test_…) تمامًا مثل المفاتيح المباشرة باستثناء أن أي شيء قد يكلف مالًا أو يصل إلى العالم الخارجي يتم محاكاته — إرسال الرسائل، وشراء الأرقام، ومكالمات الذكاء الاصطناعي الصادرة، ونشر الوكلاء، وتسجيلات 10DLC (التي تعمل في وضع المحاكاة) — مما يجعلها مثالية للتطوير وCI.

قبل أن تبدأ

• يجب أن تكون مسؤولًا أو مالكًا لمساحة العمل لإنشاء المفاتيح.
• اعرف ما يفعله وضع الاختبار وما لا يعزله: يعمل مفتاح الاختبار مقابل بيانات مساحة عملك الحقيقية. عمليات إنشاء جهات الاتصال وتحديثها وحذفها حقيقية، وتغييرات حالة المحادثة حقيقية، وحفظ مسودات الوكلاء (PATCH /v1/api/agent) حقيقية. ما يتم محاكاته هو الإنفاق: عمليات الإرسال، وشراء الأرقام، ومكالمات الذكاء الاصطناعي الصادرة، ونشر الوكلاء، وطلبات 10DLC.

خطوة بخطوة

1. انقر على الإعدادات في الشريط الجانبي، ثم واجهة برمجة تطبيقات المطور.

2. املأ نموذج الإنشاء كالمعتاد — الاسم والنطاقات (انظر الحصول على مفتاح Ody API الخاص بك).

3. ضمن نوع المفتاح، حدد اختبار. تؤكد التلميحة ذلك: مفاتيح الاختبار تقرأ بيانات حقيقية ولكنها لا ترسل رسائل نصية حقيقية أبدًا — يتم تسجيل عمليات الإرسال على أنها محاكاة.

4. انقر على إنشاء مفتاح وانسخ السر ody_test_… من اللافتة التي تظهر لمرة واحدة.

5. استخدمه تمامًا مثل المفتاح المباشر — نفس عنوان URL الأساسي، ونقاط النهاية، والنطاقات، وحدود المعدل:

curl https://api.ody.co/v1/api/messages \
  -H "Authorization: Bearer ody_test_…" \
  -H "Content-Type: application/json" \
  -d '{"to":"+15125550123","body":"CI smoke test"}'

الاستجابة هي 201 عادية مع "simulated": true، وتظهر الرسالة في المحادثة مع deliveryStatus: "simulated"."

ما هو متطابق، وما هو محاكى

السلوك	مع مفتاح ody_test_…
قراءة جهات الاتصال والمحادثات والمكالمات والأرقام	بيانات حقيقية، مطابقة للمباشر
إنشاء/تحديث/حذف جهات الاتصال	حقيقي — يغير مساحة عملك
تعيين حالة المحادثة	حقيقي
POST /v1/api/messages / MCP send_message	محاكى — مسجل، لم يتم إرساله أبدًا
POST /v1/api/numbers / MCP buy_number	محاكى — "simulated": true، لم يتم طلب أو توفير أو فرض رسوم على أي شيء
POST /v1/api/calls / MCP place_call	محاكى — معرف مكالمة sim_…، لم يتم الاتصال بأي رقم، لم يتم استخدام أي رصيد
POST /v1/api/agent/publish	محاكى — يبقى إعدادك مسودة، لا شيء يصبح مباشرًا
PATCH /v1/api/agent (حفظ المسودات)	حقيقي — نفس المباشر
POST /v1/api/messaging/registration	وضع المحاكاة — تعمل دورة 10DLC الكاملة، ولكن لا يتم تقديم أي شيء إلى السجل ولا توجد رسوم
النطاقات، حدود المعدل، الأخطاء، الترحيل، عدم التكرارية	مطابقة للمباشر
إدارة نقاط نهاية Webhook	نقاط نهاية حقيقية، نفس المباشر

في قائمة المفاتيح، تظهر مفاتيح الاختبار بشارة اختبار وتلميحة ody_test_…WXYZ حتى لا تختلط عليك مع المفاتيح المباشرة.

استخدام وضع الاختبار في CI

• أنشئ مفتاح اختبار مخصصًا لكل مسار (على سبيل المثال "GitHub Actions") حتى تتمكن من إلغائه بشكل مستقل ويبقى عمود "آخر استخدام" ذا معنى.
• قم بتخزينه كسر CI (مثل ODY_API_KEY) — لا يتغير رمزك بين البيئات، فقط المفتاح.
• تأكد من simulated: true في ردود الإرسال لاكتشاف مفتاح مباشر تم تكوينه عن طريق الخطأ في CI.
• تذكر أن عمليات كتابة جهات الاتصال حقيقية: وجه CI إلى مساحة عمل مخصصة، أو قم بتنظيف جهات الاتصال التي تنشئها اختباراتك.

مقالات ذات صلة

• الحصول على مفتاح Ody API الخاص بك
• نظرة عامة على API والمصادقة
• ربط أدوات الذكاء الاصطناعي بـ MCP
• بدء سريع لـ SDK: TypeScript و Python

---