كيفية استخدام Botoi TypeScript SDK مع 5 أمثلة حقيقية

أنت تقوم بإنشاء تطبيق Node.js وتحتاج إلى التحقق من صحة رسائل البريد الإلكتروني والتقاط لقطات الشاشة واكتشاف معلومات تحديد الهوية الشخصية (PII). تذاكر الدعم، أو إنشاء رموز QR للإيصالات. يمكنك الكتابة fetch مغلفة, التعامل مع إعادة المحاولة، وتحليل الأخطاء، ونأمل أن تظل الأنواع متزامنة مع واجهة برمجة التطبيقات. أو يمكنك تثبيت حزمة واحدة.

ال @botoi/sdk الحزمة تعطيك كتابتها الوصول إلى أكثر من 150 نقطة نهاية مع إعادة المحاولة التلقائية وفئات الأخطاء وعدم التبعيات. هذا المنصب يمشي من خلال خمسة أمثلة للنسخ واللصق يمكنك شحنها اليوم.

التثبيت والتهيئة

يقرأ SDK BOTOI_API_KEY من بيئتك بشكل افتراضي. لا يوجد مفتاح API؟ مجهول الوصول يعمل بمعدل 5 طلبات في الدقيقة و 100 في اليوم. تحتوي الحزمة على صفر تبعيات و يتطلب Node.js 20+.

خمسة أشياء يمكنك بناءها اليوم

قم بمسح إدخال المستخدم لمعرفة معلومات تحديد الهوية الشخصية (PII) قبل التسجيل

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

إجابة:

كل نتيجة تشمل الكيان type، المتطابقة value، و start/end مواقف الشخصيات. استخدم هذه الإزاحات لتحل محل العناصر الحساسة النص مع [REDACTED] قبل الكتابة إلى السجلات.

إنشاء مخططات Zod من استجابات API

تحصل على JSON من واجهة برمجة تطبيقات تابعة لجهة خارجية وتحتاج إلى التحقق من صحة وقت التشغيل. مخططات Zod للكتابة اليدوية لـ a تستغرق نية الدفع ذات 30 حقلاً وقتًا لا تملكه. ال schema.jsonToZod تنشئ الطريقة المخطط من أي كائن JSON.

الإخراج:

الصق الإخراج في قاعدة التعليمات البرمجية الخاصة بك، أضف import { z } from "zod"وأنت لديك أنواع تم التحقق من صحتها في وقت التشغيل في أقل من 30 ثانية. يتم التعامل مع الكائنات والمصفوفات المتداخلة بشكل متكرر.

اكتشف مجموعة التكنولوجيا التي يستخدمها المنافس

عادةً ما يعني البحث عن المنافسين فتح DevTools والتخمين من خلال علامات البرنامج النصي. ال techDetect.detect تقوم الطريقة بمسح عنوان URL وإرجاع النتائج المصنفة؛ الأطر, التحليلات وشبكات CDN وموفري الاستضافة والمزيد.

إجابة:

تتضمن كل تقنية درجة ثقة وفئة. مفيدة لذكاء المبيعات والسوق البحث، أو تدقيق المكدس الخاص بك.

التقاط لقطات شاشة لكامل الصفحة برمجياً

صور المعاينة الاجتماعية وتقارير PDF واختبارات الانحدار المرئي. انهم جميعا بحاجة إلى لقطات الشاشة. ال screenshot.capture تقوم الطريقة بإرجاع ثنائي Response كائن يمكنك الكتابة مباشرة على القرص.

تقوم نقاط النهاية الثنائية (لقطات الشاشة وملفات PDF والصور) بإرجاع ملف خام Response. يتصل .arrayBuffer() للحصول على البايتات. تدعم نقطة النهاية إطارات العرض المخصصة والصفحة الكاملة التقاط وتنسيقات PNG/JPEG/WebP.

قم بإنشاء رموز QR بتنسيق SVG

الإيصالات وتذاكر الأحداث والمواد التسويقية. تظهر رموز QR في كل مكان. ال qr.generate تُرجع الطريقة SVG افتراضيًا، مما يعني تحجيمًا لا نهائيًا وصغيرًا أحجام الملفات.

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

معالجة الأخطاء تساعدك على التعافي

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

يقوم SDK بإعادة المحاولة التلقائية للأخطاء 429 و5xx مع التراجع الأسي (ما يصل إلى 3 محاولات بشكل افتراضي). يتم حل معظم حالات الفشل العابرة دون أن تلمسها التعليمات البرمجية الخاصة بك. ال BotoiRateLimitError يتضمن أ retryAfter الخاصية في ثوانٍ، حتى تتمكن من إنشاء عمليات احتياطية قائمة على قائمة الانتظار لأحمال العمل كبيرة الحجم.

خيارات التكوين