التكامل مع REST API: الوكلاء والبيانات في أنظمتك الخاصة

كل ما في لوحة التحكم متاح عبر REST API، لذا يمكنك استخدام الوكلاء داخل موقعك الإلكتروني أو تطبيقك للجوال أو نظام إدارة علاقات العملاء (CRM) أو مركز الاتصال، ودفع البيانات تلقائياً.

1. أنشئ مفتاحاً

في لوحة التحكم، افتح API & keys، وأعطِ المفتاح اسماً يشير إلى مكان استخدامه (مثل mobile-app-prod) وانقر Create key. انسخه الآن: يُخزَّن بصمة المفتاح فقط، لذا لا يمكن عرضه مرة أخرى. احتفظ به ضمن أسرار الخادم لديك، ولا تضعه أبداً في موقع إلكتروني أو تطبيق يمكن للعملاء تنزيله.

2. استدعِ وكيلاً

curl https://servicebuddy.com/api/v1/agents/auto/runs \
  -H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"Where is my order 1004?"}]}'

• يتيح auto للموجّه اختيار الوكيل؛ أو استخدم مفتاحاً محدداً مثل personal-shopper.
• أضف "stream": true لتلقي الإجابة كلمة بكلمة (server-sent events)، إضافة إلى أحداث المنتجات والمتاجر والإرجاع التي يمكنك عرضها كبطاقات.

3. ادفع البيانات

curl https://servicebuddy.com/api/v1/datasets -H "Authorization: Bearer $API_KEY" \
  -F entity=product -F [email protected]

تتم مطابقة الملف تلقائياً ومعالجته. تحقق من التقدم عبر GET /api/v1/datasets/{id}.

نقاط النهاية

إبطال مفتاح

انقر Revoke بجانبه. تتوقف الاستدعاءات بهذا المفتاح فوراً.