ملخص

يساعدك هذا المقال في تصحيح المشكلات الشائعة عند استخدام إجراءات واجهة برمجة التطبيقات (REST API) في Astra. فإنه يغطي المشكلات الشائعة مثل 매개 변수 النموذج المفقود، والقيود المرتبطة ببيانات العملاء المحتملين، وأخطاء المصادقة، والمعايير الأمنية المهمة للحفاظ على تشغيل التكاملات بشكل موثوق.

التعليمات

تم ارسال النموذج: معاملات غير ممررة

المشكلة

تستلم واجهة برمجة التطبيقات (REST API) قيمًا فارغة أو مفقودة عند ارسال نموذج مخصص.

السبب

عادةً ما يحدث ذلك عندما لا يتطابق المكاني المُستخدم في تكوين واجهة برمجة التطبيقات (REST API) بشكل دقيق مع اسم حقل النموذج.

التطابق هو حساس لحالة الحروف ويستند إلى لاحقة المكاني (الجزء بعد النقطة الأخيرة .).

كيفية إصلاحها

تأكد من أن لاحقة المكاني تتطابق بشكل دقيق مع اسم حقل النموذج.

أمثلة:

حقل النموذج first_name → المكاني {{first_name}} أو {{contact.first_name}}
حقل النموذج firstName → المكاني {{contact.first_name}}
- السبب: عدم تطابق الحالة (firstName ≠ first_name)

بعد تصحيح المكاني، احفظ الإجراء واختبره مرة أخرى.

تم أسرع الزبون: حقل مخصص لا يعمل

المشكلة

تريد ارسال حقول إضافية أو مخصصة مع حدث تم أسرع الزبون.

السبب

يرسل حدث تم أسرع الزبون دائمًا هيكلاً ثابتًا لجسم الطلب. لا تدعم الحقول المخصصة لنوع حدث هذا.

تُتجاهل أي تكوين مخصص لجسم الطلب request_body.

ما يمكنك فعله بدلاً من ذلك

إذا كنت بحاجة إلى ارسال بيانات مخصصة، استخدم واحدًا من الخيارات التالية:

حدث تم ارسال النموذج مع نموذج مخصص
مسبب قائم على النية مع جسم طلب قابل للتخصيص

تمكنك هذه الخيارات من التحكم بدقة في البيانات التي تُرسل إلى واجهة برمجة التطبيقات (API).

أخطاء المصادقة

المشكلة

تعيد واجهة برمجة التطبيقات (API) خطأ 401 Unauthorized.

كيفية إصلاحها

تحقق من صحة مفتاح واجهة برمجة التطبيقات (API) أو رمز العرض الخاص بك
تأكد من أن رمز العرض لم انتهِ صلاحيته

بعد تحديث بيانات الاعتماد، اختبر الإجراء مرة أخرى.

ملاحظات أمنية

تتضمن Astra حماية مدمجة لحماية بياناتك والتكاملات.

بيانات الاعتماد محمية
- يتم إخفاء مفاتيح واجهة برمجة التطبيقات (API) وكلمات المرور (*****) عند عرض تفاصيل الإجراء
حماية من الاحتيال بالطلبات من جانب الخادم (SSRF)
- تُحظر الطلبات إلى عناوين الشبكة الداخلية أو الخاصة تلقائيًا
وضع الاختبار متاح
- استخدم وضع الاختبار لتحقق من صحة إجراء واجهة برمجة التطبيقات (REST API) دون التأثير على البيانات الحية أو التحليلات