المصادقة

Authorization: Bearer <token>

البادئة Bearer مطلوبة. إرسال الرمز بدونها يعيد 401.

بيانا اعتماد، ترويسة واحدة

رمز الوصول الشخصي. تجده في الإعدادات ← الملف الشخصي. سلسلة سداسية عشرية من 48 حرفًا تحمل دورك الكامل ولا تنتهي صلاحيتها. مناسب للاستكشاف؛ بدّله عبر POST /core/profile/reset_access_token إذا تسرّب. مفتاح API محدود النطاق. ينشئه مدير الحساب من الحساب ← واجهة المطور API. يُعرف بالبادئة hc_ ويحمل فقط النطاقات التي تختارها داخل HueChat، مع حد معدل خاص به وقائمة IP اختيارية وتاريخ انتهاء. يتم إنشاء المفاتيح وتدويرها ومراجعتها وإلغاؤها من تطبيق HueChat بعد تسجيل الدخول؛ ولا تُنشر عمليات إدارة الحساب هذه في بوابة المطورين. يعمل المفتاح على /core/accounts/{account_id}/… و /api/v2/accounts/{account_id}/… فقط؛ لا يستطيع قراءة ملفك الشخصي ولا فتح جلسة. كلاهما يُرسل في الترويسة نفسها، والخادم يميّز بينهما من البادئة.

النطاق

الرمز الشخصي يتصرف باسمك. المفتاح المحدود يتصرف باسم الحساب ضمن النطاقات الممنوحة له. عندما يفتقر المفتاح إلى نطاق تكون الاستجابة 403:

{ "error": "API key scope is not authorized for this route" }

يذكر كل دليل API النطاقات الدقيقة المطلوبة. وتُجمَّع النطاقات بالطريقة نفسها في منتقي النطاقات داخل HueChat:

المجال	النطاقات
بيانات العملاء Customer CDP	`contacts:read` و`contacts:write` و`contacts:delete` و`contact_lists:read` و`contact_lists:write` و`contact_lists:delete` و`cdp:read` و`cdp:write` و`membership:events`
المبيعات	`sales:read` و`sales:write` و`companies:read` و`companies:write` و`quotes:read` و`quotes:write` و`products:read` و`products:write` و`tasks:read` و`tasks:write` و`leads:read` و`leads:write` و`deals:read` و`deals:write` و`deals:delete`
الخدمة	`tickets:read` و`tickets:write` و`appointments:read` و`appointments:write` و`appointments:sync` و`forms:read` و`forms:write`
الأتمتة	`workflows:read` و`workflows:write` و`ai_agents:read` و`ai_agents:write`

تقبل مسارات المبيعات وبيانات العملاء نطاقها المخصص (مثل quotes:read أو cdp:read) أو النطاق الأوسع deals:* / contacts:*، لذلك تستمر المفاتيح التي أُنشئت قبل النطاقات المخصصة في العمل. امنح التكاملات الجديدة النطاقات المخصصة فقط. منتقي النطاقات داخل HueChat هو المرجع المعتمد لحسابك.

الحفاظ على الأمان

من جهة الخادم فقط. أي رمز في كود المتصفح يصبح علنيًا لحظة نشر الحزمة، والرمز الشخصي يستطيع فعل كل ما يستطيعه مستخدمك.

احفظه في متغير بيئة أو مدير أسرار. فضّل مفتاحًا محدودًا بأصغر مجموعة نطاقات وتاريخ انتهاء وقائمة IP. إذا تسرّب أحدها، ألغه أو بدّله من الحساب ← واجهة المطور API؛ تتوقف القيمة القديمة فورًا.

التحقق من أن الرمز يعمل

curl -i "https://app.huechat.ai/core/accounts/$ACCOUNT_ID/conversations?page=1" \
  -H "Authorization: Bearer $HUECHAT_TOKEN"

200 تعني أن بيانات الاعتماد مخوّلة لهذا الطلب. عند 401، تحقّق من الرمز وصيغة Authorization: Bearer. وعند 403، تحقّق من أن معرّف الحساب يطابق حساب المفتاح، وأن مالك المفتاح ما زال يملك صلاحية الوصول، وأن المفتاح يتضمن النطاق conversations:read.

ابدأ هنا

العمل مع الواجهة

التكامل

المصادقة

بيانا اعتماد، ترويسة واحدة

النطاق

الحفاظ على الأمان

التحقق من أن الرمز يعمل

​بيانا اعتماد، ترويسة واحدة

​النطاق

​الحفاظ على الأمان

​التحقق من أن الرمز يعمل

بيانا اعتماد، ترويسة واحدة

النطاق

الحفاظ على الأمان

التحقق من أن الرمز يعمل