عن webhooks
تتيح لك Webhooks إرسال طلب POST إلى عنوان URL معين في كل مرة يتم فيها تشغيل التنبيه. يمكن تمكين هذه الميزة عند إنشاء تنبيه أو تعديله. أضف عنوان الموقع URL الصحيح لتطبيقك وسنرسل طلب POST بمجرد تشغيل التنبيه ، مع رسالة التنبيه في نص الطلب. إذا كانت رسالة التنبيه صالحة بصيغة JSON ، فسنرسل طلبًا يحتوي على content-type header "application / json". خلاف ذلك ، سوف نرسل "text/plain" كـ content-type header.
إشعار أمان هام: عند تكوين webhooks، تأكد من عدم تضمين معلومات حساسة مثل بيانات اعتماد تسجيل الدخول أو كلمات المرور في نص webhook. يمكن أن يؤدي نقل البيانات الحساسة من خلال webhooks إلى تعريضها لأطراف غير مصرح بها ويؤدي إلى ثغرات أمنية. استخدم دائمًا نقاط نهاية آمنة ومصدقة وقم بتشفير البيانات الحساسة لحماية معلوماتك.
فيما يلي قائمة بعناوين IP التي سنستخدمها لإرسال طلبات POST ، في حالة الحاجة إلى إذن:
- 52.89.214.238
- 34.212.75.30
- 54.218.53.128
- 52.32.178.7
إذا كنت ترغب في إرسال طلب إلى عنوان به رقم منفذ ، يرجى ملاحظة أننا نقبل فقط عناوين التي تحتوي على رقمين المنفذين 80 و 443. سيتم رفض الطلب على أي عنوان مع أي رقم منفذ آخر. إذا قام الخادم البعيد بمعالجة طلب لأكثر من 3 ثوان ، فسيتم إلغاء الطلب.
ضع في اعتبارك أن العديد من التطبيقات والخدمات تتوقع استلام البيانات من webhooks بتنسيق JSON (وليس النص العادي الذي لدينا في رسالة التنبيه بشكل افتراضي). قبل إرسال الطلب ، يرجى قراءة وثائق التطبيق أو الخدمة المقابلة وتنسيق رسالة التنبيه بشكل صحيح. يمكنك معرفة المزيد حول تنسيق JSON في الويكي.
على سبيل المثال ، ينتظر Slack رسالة منسقة في JSON مع "نص" كمفتاح. يمكنك الكتابة في مربع رسالة:
{"text": "BTCUSD Greater Than 9000"}
curl -H 'Content-Type: application/json; charset=utf-8' -d '{"text": "BTCUSD Greater Than 9000"}' -X POST https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXXإذا كانت رسالتك في نص عادي (على سبيل المثال ، كنت تستخدم رسالة تنبيه افتراضي) ، فسنرسل طلبًا يحتوي على رأس نوع المحتوى "عادي / نص".
curl -H 'Content-Type: text/plain; charset=utf-8' -d 'BTCUSD Greater Than 9000' -X POST https://webhook.site/test