← العودة إلى الصفحة القانونية

شروط واجهة برمجة التطبيقات للمطورين

مسودة — قيد المراجعة القانونية الخارجية. يحدد هذا المستند المتطلبات وقرارات المنتج التي يجب أن يعكسها النص النهائي؛ ولم تتم مراجعته من قبل محامٍ. لا يشكل هذا المستند استشارة قانونية ولا نسخة نهائية قابلة للنشر.

آخر تحديث: [تاريخ السريان]

1. النطاق

تحكم شروط واجهة برمجة التطبيقات للمطورين هذه ("شروط API") الوصول إلى واجهة برمجة التطبيقات (REST API) العامة لـ iNTELIGENCIA VIVA (الإصدار v1) واستخدامها، وكذلك نقطة النهاية الخاصة بالبث المباشر عبر WebSocket، من قِبل أي Workspace أو مطوّر يتصرف نيابة عنه ("أنت"، أو "المطوّر"). وتُكمّل هذه الشروط شروط الخدمة وسياسة الاستخدام المقبول ولا تحل محلهما، وتُدرَجان هنا بالإحالة.

2. الوصول والمصادقة

يتطلب الوصول إلى واجهة برمجة التطبيقات مفتاح API (‏APIKey‏) صادراً من لوحة تحكم Workspace، بنطاق صلاحيات قابل للتهيئة لكل مفتاح. تُصادَق الطلبات باستخدام ترويسة Authorization: Bearer sk_live_.... أنت مسؤول عن الحفاظ على سرية مفاتيحك؛ وفي حال تعرّض مفتاح للاختراق، يجب إلغاؤه فوراً من لوحة التحكم. لن نُفصح عن القيمة الكاملة لأي مفتاح بعد إنشائه، إلا لصاحبه نفسه لحظة إصداره.

3. الموارد والإصدار

تعرض واجهة برمجة التطبيقات، في إصدارها v1، الموارد التالية: ‏Workspace‏، وContact‏، وConversation‏، وMessage‏، وDepartment‏، وAgent‏، وAIAgent‏، وKnowledgeSource‏، وChannel‏، وWebhook‏، وAPIKey‏. وتتيح نقطة نهاية للبث عبر WebSocket (‏wss://api.inteligenciaviva.com/v1/workspaces/{id}/stream‏) استهلاك الأحداث المباشرة كبديل أو مكمّل للـ Webhooks.

يجوز لنا إضافة موارد وحقول وأحداث بشكل متوافق مع الإصدارات السابقة دون إشعار مسبق. أما التغييرات التي تكسر التوافق، فستُطرح ضمن إصدار جديد من واجهة برمجة التطبيقات، مع فترة تعايش معقولة بين الإصدارات وإشعار مسبق عبر لوحة تحكم المطورين أو البريد الإلكتروني المسجَّل لـ Workspace.

4. حدود المعدّل

يخضع الوصول إلى واجهة برمجة التطبيقات لحدود معدّل (rate limits) موثّقة علناً في قسم المطورين على الموقع، وقابلة للتعديل الدوري وفقاً لقدرة الخدمة وخطة Workspace. تُشار الاستجابات التي تتجاوز الحد برمز حالة HTTP المعني (‏429‏) وترويسات الحد الساري؛ وأنت مسؤول عن تطبيق استراتيجية إعادة محاولة بتأخير تصاعدي (backoff). وتُعد محاولة تجاوز هذه الحدود مخالفة لسياسة الاستخدام المقبول.

5. الـ Webhooks

عندما تشترك في أحداث صادرة (‏conversation.created‏، وconversation.assigned‏، وconversation.resolved‏، وmessage.received‏، وmessage.sent‏، وhandoff.requested‏، وai_agent.tool_call‏)، يُوقَّع كل تسليم رقمياً باستخدام HMAC وباستخدام السر المرتبط بـ WebhookEndpoint الخاص بك. أنت مسؤول عن التحقق من هذا التوقيع قبل معالجة محتوى التسليم، وعن الاستجابة برمز نجاح خلال وقت معقول؛ وسنعيد محاولة عمليات التسليم الفاشلة وفقاً لسياسة إعادة المحاولة السارية لدينا، دون ضمان تسليم لمرة واحدة بالضبط (exactly-once)، بل على أساس تسليم مرة واحدة على الأقل (at-least-once).

6. الاستخدام المسموح به للبيانات المستحصل عليها عبر واجهة برمجة التطبيقات

تنتمي البيانات التي تحصل عليها عبر واجهة برمجة التطبيقات — وبخاصة بيانات Contact‏ وConversation‏ وMessage‏ — إلى نطاق Workspace الذي أصدر المفتاح المستخدَم، ولا يجوز لك استخدامها إلا للأغراض التي صرّح بها ذلك Workspace (مثل المزامنة مع نظام إدارة علاقات العملاء الخاص بك، أو التوجيه إلى نظام داخلي، أو الأدوات التي يمكن لـ AIAgent‏ استدعاؤها). وعلى وجه الخصوص، ودون الإخلال بما تنص عليه سياسة الاستخدام المقبول، يُحظر عليك:

7. إلغاء الوصول

يجوز لصاحب Workspace إلغاء أي مفتاح API في أي وقت من لوحة تحكمه، وبأثر فوري. كما يجوز لنا إلغاء أو تعليق وصول مفتاح، أو WebhookEndpoint‏، أو تكامل محدد، دون إشعار مسبق، عندما نكتشف استخداماً مخالفاً لشروط API هذه، أو لسياسة الاستخدام المقبول، أو خطراً أمنياً على الخدمة أو على Workspaces أخرى. وحيثما أمكن ذلك بشكل معقول، سنُخطر صاحب Workspace المتأثر بالإلغاء وسببه.

8. التوفر والدعم

تُقدَّم واجهة برمجة التطبيقات وفقاً لنفس معيار التوفر الخاص بخطة Workspace الذي صدر المفتاح بموجبها؛ وقد تتضمن خطط Enterprise اتفاقية مستوى خدمة (SLA) تعاقدية منفصلة خاصة بواجهة برمجة التطبيقات. وفيما عدا ذلك، تُقدَّم واجهة برمجة التطبيقات على أساس بذل أفضل جهد، دون ضمان وقت تشغيل محدد.

9. الامتثال لسياسة الاستخدام المقبول

يخضع كل استخدام لواجهة برمجة التطبيقات لسياسة الاستخدام المقبول، بما في ذلك أحكامها الخاصة بتجاوز حدود المعدّل، والاستخراج الجماعي للبيانات (scraping)، واستخدام البيانات لتدريب نماذج منافسة.

10. المسؤولية

تُقدَّم واجهة برمجة التطبيقات "كما هي". وإلى أقصى حد يسمح به القانون المعمول به في كوستاريكا، فإننا لا نضمن خلو واجهة برمجة التطبيقات من الأخطاء أو الانقطاعات، وتخضع مسؤوليتنا تجاهك عن استخدام واجهة برمجة التطبيقات للحدود المنصوص عليها في شروط الخدمة.

11. تعديلات شروط API هذه

يجوز لنا تحديث شروط API هذه لتعكس تطور المنصة. وستُبلَّغ التغييرات الجوهرية بإشعار معقول مسبق عبر لوحة تحكم المطورين أو عبر البريد الإلكتروني.

12. التواصل مع المطورين

للاستفسارات التقنية أو القانونية المتعلقة باستخدام واجهة برمجة التطبيقات: developers@inteligenciaviva.com