المطورون / الوكلاء

عرض ويدجت موقع وكيل

GET https://api.echonova.ai/v1/agents/{agentId}/widget

تعيد إعدادات ويدجت موقع الوكيل. تكون `data` بقيمة `null` إذا لم يكن للوكيل ويدجت بعد. يحتاج المفتاح إلى النطاق `agents:read`.

Headers

Authorization string مطلوب

كلمة ⁦Bearer⁩ ثم مسافة ثم مفتاح ⁦API⁩ الذي يبدأ بـ ⁦ek_⁩. أنشئ المفاتيح في البوابة من المطورون، ثم مفاتيح واجهة برمجة التطبيقات.

معاملات المسار

agentId string مطلوب

معرّف الوكيل كما أعادته `GET /v1/agents`.

الاستجابة

200 application/json كل استجابة تستخدم هذا الغلاف.

data object

النتيجة.

success boolean

قيمته ⁦true⁩ عند نجاح الطلب.

statusCode integer

يكرر رمز حالة ⁦HTTP⁩.

errorMessage string or null

قيمته ⁦null⁩ عند النجاح.

الأخطاء

الغلاف نفسه، مع ⁦success⁩ بقيمة ⁦false⁩ و ⁦data⁩ بقيمة ⁦null⁩. كل الأخطاء

GET /v1/agents/{agentId}/widget

curl "https://api.echonova.ai/v1/agents/{agentId}/widget" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": {
    "publicId": "wdg_a1B2c3D4e5F6",
    "enabled": true,
    "mode": "private",
    "allowedOrigins": [
      "https://shop.example.com"
    ],
    "look": {
      "theme": "auto",
      "position": "end"
    }
  },
  "success": true,
  "statusCode": 200,
  "errorMessage": null
}