تم استخدام باخرة لبرمجة تطبيقات البث المباشر

مقدمة

توفر واجهة برمجة تطبيقات BuiltWith WebSocket Live Feed إشعارات فورية لاكتشاف التقنيات الجديدة عبر اتصالات WebSocket. اشترك في قنوات التقنية واحصل على تحديثات فورية عند اعتماد المواقع الإلكترونية للتقنيات الجديدة أو تغييرها.

الاتصال بنقطة نهاية WebSocket:
wss://sync.builtwith.com/wss/new?KEY=00000000-0000-0000-0000-000000000000

أو قم بالاتصال والاشتراك تلقائيًا في قناة تقنية:
wss://sync.builtwith.com/wss/channel/Shopify?KEY=00000000-0000-0000-0000-000000000000

الميزات الرئيسية:
  • إشعارات الكشف عن التكنولوجيا في الوقت الفعلي
  • اشترك في تقنيات محددة (مثل Shopify أو WordPress) أو في قناة "الجديد" للمواقع الإلكترونية الجديدة كليًا
  • يحصل المستخدمون التجريبيون/المعاينون على أسماء نطاقات محجوبة لتجربة المحتوى.
  • دعم إعادة الاتصال التلقائي
متطلبات الخطة:
  • أنت بحاجة إلى خطة فعّالة لاستخدام واجهة برمجة تطبيقات البث المباشر
  • الأساسي: اشتراكان تقنيان كحد أقصى لكل مفتاح API
  • ميزة: ما يصل إلى 50 اشتراكًا تقنيًا لكل مفتاح API
  • تتلقى الحسابات التجريبية والحسابات المنتهية الصلاحية بيانات مشوشة
المصادقة

تتطلب اتصالات WebSocket مفتاح API الخاص بك كمعامل استعلام.

المعلمةوصفمطلوب
KEY00000000-0000-0000-0000-000000000000
مفتاح واجهة برمجة التطبيقات (API) الخاص بك من BuiltWith (بتنسيق GUID)
نعم
SUBSCRIBEShopify أو new
اختياري: الاشتراك التلقائي في قناة عند الاتصال (يستخدم مع نقطة النهاية /wss/channel/{tech})
لا
أوضاع العرض:
  • الوصول الكامل: يحصل المشتركون النشطون المدفوعون على أسماء نطاقات كاملة
  • محذوف/معاينة: يحصل المستخدمون التجريبيون والاشتراكات المنتهية الصلاحية على نطاقات محجوبة (على سبيل المثال، يصبح 'great.com' هو 'grxxt.cxm')
نقاط نهاية WebSocket
نقطة النهايةوصف
wss://sync.builtwith.com/wss/newاتصل بالبث المباشر. بعد الاتصال، أرسل أوامر الاشتراك للانضمام إلى القنوات.
wss://sync.builtwith.com/wss/channel/{tech}قم بالاتصال والاشتراك تلقائيًا في قناة تقنية محددة (على سبيل المثال، /wss/channel/Shopify)
أوامر العميل
أرسل أوامر JSON هذه بعد الاتصال لإدارة اشتراكاتك
يأمروصف
{"action":"subscribe","channel":"Shopify"}اشترك في قناة تقنية. استخدم أسماء تقنية مثل "Shopify" أو "WordPress"، أو استخدم قنوات قواعد النطاق مثل "جديد" و"جديد-تاريخي" و"مميز".
{"action":"subscribe","channel":"new"}الاشتراك في النطاقات المصنفة وفقًا لقاعدة "الجديد": النطاق تم إنشاؤه حديثًا في هذه السلسلة وجميع التقنيات المكتشفة تم اكتشافها لأول مرة خلال اليوم الأخير.
{"action":"subscribe","channel":"new-historical"}الاشتراك في النطاقات المصنفة وفقًا لقاعدة "التاريخية الجديدة": يتم إنشاء النطاق حديثًا في هذه السلسلة وجميع التقنيات المكتشفة لديها تاريخ اكتشاف أولي أقدم من أو يساوي يومًا واحدًا.
{"action":"subscribe","channel":"premium"}اشترك في النطاقات المصنفة وفقًا لقاعدة "المميزة": النطاق تم إنشاؤه حديثًا، ويحتوي على تقنية واحدة على الأقل ذات أولوية > 0، وجميع التقنيات المكتشفة تم اكتشافها لأول مرة خلال اليوم الأخير.
{"action":"unsubscribe","channel":"Shopify"}إلغاء الاشتراك في قناة.
{"action":"list_subscriptions"}أدرج اشتراكاتك الحالية في القنوات.
أنواع القنوات
قناةوصف
newقناة القواعد. المجال جديد في خط الأنابيب، وجميع التقنيات تم ا��تشافها حديثًا (خلال يوم واحد).
new-historicalقناة القواعد. المجال جديد في خط الأنابيب ويتم اكتشاف جميع التقنيات تاريخيًا لأول مرة (أقدم من أو يساوي يومًا واحدًا).
premiumقناة القواعد. المجال جديد، ويحتوي على تقنية واحدة على الأقل ذات أولوية > 0، وتم اكتشاف جميع التقنيات لأول مرة مؤخرًا (خلال يوم واحد).
{technology_name}اشترك في تقنية محددة بالاسم (مثل: "Shopify" أو "WordPress" أو "Google Analytics"). استخدم الأسماء مع علامة (-) لاستبدال المسافات.
تنسيقات الرسائل
رسائل الخادم
الرسائل الواردة من خادم WebSocket
تم تأكيد الاتصال
{
  "type": "connected",
  "message": "Connected successfully...",
  "available_commands": ["subscribe", "unsubscribe", "list_subscriptions"],
  "view_mode": "full"
}
تم تأكيد الاشتراك
{
  "type": "subscribed",
  "channel": "Shopify",
  "channel_id": "a1b2c3d4-..."
}
رسالة الكشف عن التكنولوجيا
{
  "type": "message",
  "channel": "Shopify",
  "channel_id": "a1b2c3d4-...",
  "data": {
    "channel_name": "Shopify",
    "website_domain": "example.com",
    "epoch_secs": 1770508800
  }
}
تغيير الحالة (تم تغيير مستوى الاشتراك)
{
  "type": "status_change",
  "view_mode": "full",
  "message": "Your subscription has been upgraded. You now have full data access."
}
رسالة خطأ
{
  "type": "error",
  "message": "Technology 'unknown-tech' not found"
}
حقول الرسائل
مجالوصف
typeنوع الرسالة: متصل، مشترك، غير مشترك، رسالة، تغيير الحالة، خطأ، معلومات
channelاسم القناة الودود (مثلاً، 'Shopify'، 'جديد')
channel_idمعرّف القناة الداخلية (معرّف التكنولوجيا الفريد أو "جديد")
dataحمولة الكشف مع اسم القناة، ونطاق الموقع الإلكتروني، وعدد الثواني لكل حقبة
website_domainالمجال الذي تم فيه رصد التكنولوجيا (تم حجب المعلومات لمستخدمي النسخة التجريبية)
epoch_secsالطابع الزمني لعصر يونكس (بالثواني) لوقت وضع عملية الكشف في قائمة الانتظار
view_mode«كامل» للمشتركين المدفوعين، و«محذوف (تجريبي/معاينة)» لمستخدمي النسخة التجريبية
المجالات الخاصة

نحتفظ بقائمتين لاستخدامك عند البحث عن النطاقات: قوائم التجاهل وقوائم اللاحقات المبنية.

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

BuiltWith قائمة اللواحق
وهذا يعتمد على قائمة اللواحق العامة لكنها تتضمن العديد من الإدخالات الإضافية للشركات التي لديها نطاقات فرعية يجب اعتبارها نطاقات المستوى الأعلى. توفر لنا هذه القائمة رؤية أفضل لمواقع الويب الداخلية، على سبيل المثال، فهي ترفع موقع northernbeaches.nsw.gov.au إلى المستوى الأعلى مقارنة بـ nsw.gov.au.

تجاهل المجالات (XML, JSON or TXT)
https://api.builtwith.com/ignoresv1/api.json
نطاقات اللواحق (XML, JSON or TXT)
https://api.builtwith.com/suffixv1/api.json
رموز الخطأ

لاحظ أن رسائل الخطأ بهذا التنسيق لا يمكن ضمانها، ويجب على تطبيقك أيضًا أن يأخذ في الاعتبار أكواد الاستجابة غير 200 كأخطاء. ستكون خاصية البحث فارغة (json) أو غير متوفرة (xml) إذا كان الخطأ متعلقًا بالخادم. عرض جميع رموز الأخطاء المحتملة ذات التكوين الجيد.

شروط الاستخدام

ملكنا الشروط القياسية تغطية استخدام كافة واجهات برمجة التطبيقات لدينا.

بشكل عام، يمكنك استخدام واجهة برمجة التطبيقات (API) لتحسين منتجك بطرق عديدة. القيد الوحيد هو عدم إمكانية إعادة بيع البيانات كما هي أو توفير وظائف مكررة لـbuiltwith.com والخدمات المرتبطة بها.