خطافات الويب

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

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

تسجيل نقطة نهاية

أعطنا عنوان HTTPS تتحكم فيه. نرسل إليه حمولات أحداث موقّعة. وتُحدَّد البيئة عند تسجيل نقطة النهاية ولا يمكن تغييرها بعد ذلك، فنقطة النهاية في صندوق الاختبار تبقى في صندوق الاختبار مدى حياتها.

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

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

اختيار الأحداث

لا تتلقى نقطة النهاية إلا الأحداث المشتركة فيها. ومن الأحداث الشائعة:

تبدأ نقطة النهاية الجديدة وقد حُدّدت فيها مسبقًا أحداث الموافقة والرفض والمراجعة وانتهاء الصلاحية وverification.data_updated، ويمكنك تغيير الاختيار قبل الحفظ. وكل نقطة نهاية كانت موجودة قبل أن يصبح تعديل بيانات مقدم الطلب ممكنًا، وكانت مشتركة في حدث واحد على الأقل، أُضيف إليها verification.data_updated تلقائيًا.

الكتالوج الكامل، مع الحمولات، موجود في أحداث خطافات الويب.

نقطة النهاية غير المشتركة في أي حدث لا تتلقى شيئًا، والقائمة تقول ذلك بوضوح. وكذلك نقطة النهاية المشتركة في اسم حدث لم يعد شيء يرسله.

التوجيه حسب مفتاح الواجهة البرمجية

يُطابَق كل حدث مع مفتاح الواجهة البرمجية الذي أنشأ الجلسة، وبهذا يرسل الحساب الواحد الذي يدير عدة أنشطة تجارية نتائج كل نشاط إلى نظامه الخاص.

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

تراقب وحدة التحكم الطريقتين اللتين يفشل بهما هذا الأمر، وتخبرك قبل أن يخبرك عملاؤك.

مفتاح لا يستقبله شيء. إنشاء مفتاح واجهة برمجية لا يشركه في أي شيء، فعمليات التحقق التي تُجرى به لا تذهب إلى أي مكان إلى أن تضيفه إلى نقطة نهاية أو تضبط نقطة نهاية على جميع المفاتيح.

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

الاختبار قبل الاعتماد عليه

أرسل حدث اختبار يرسل حمولة نموذجية إلى نقطة النهاية في الحال، موقّعة بمفتاحها السري الحالي. وهي لا تخص أحدًا: المعرّفات بداخلها وهمية بشكل واضح، والغلاف معلَّم بأنه اختبار، فيستطيع معالجك تمييزها عن الحركة الحقيقية. وفيما عدا ذلك يطابق المحتوى ما نرسله فعليًا، فالمعالج الذي يقبل الاختبار يقبل الشيء الحقيقي.

هناك فترة انتظار قصيرة بين الاختبارات.

متابعة عمليات التسليم

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

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

للاطلاع على السجل الكامل، والتصفية، وإمكانية إعادة إرسال تسليم بعينه، انتقل إلى السجلات.

التعطيل والحذف

التعطيل يوقف عمليات التسليم إلى أن تعيد تفعيلها، وهذا ما تريده أثناء الصيانة لديك. أما الحذف فنهائي، ونتوقف عن الإرسال إلى ذلك العنوان كليًا.

ولا يُضيّع أي منهما عمليات التحقق. فالأحداث التي تعذّر تسليمها تُعاد محاولتها، ويمكن إعادة إرسال أي تسليم يدويًا بعد ذلك.

أن تُبلَّغ عندما يتعطل

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