تنزيل truecallerjs - تنزيل كود مصدر truecallerjs

truecallerjs

شفرة المصدر الأخرى

v2.2.0

تنزيل

TruecallerJS

مرحبًا بك في TruecallerJS! هذه مكتبة لاسترداد تفاصيل رقم الهاتف باستخدام Truecaller API. فهو يوفر طريقة بسيطة ومريحة للوصول إلى معلومات حول أرقام الهواتف في مشاريع Node.js وJavaScript وTypeScript.

وصف

تم تصميم TruecallerJS لتبسيط عملية جلب تفاصيل رقم الهاتف. باستخدام هذه المكتبة، يمكنك بسهولة دمج وظائف Truecaller في تطبيقات Node.js وJavaScript وTypeScript. إنه يلخص تعقيدات التفاعل مع Truecaller API ويوفر واجهة مبسطة لجلب معلومات رقم الهاتف ومعالجتها.

سمات

البحث عن رقم الهاتف : احصل على معلومات تفصيلية حول رقم الهاتف، بما في ذلك اسم المالك وموقعه والمزيد.
دعم Node.js وJavaScript وTypeScript : يمكن استخدام TruecallerJS في مشاريع Node.js، وكذلك في تطبيقات JavaScript وTypeScript.
بسيط وخفيف الوزن : تم تصميم TruecallerJS ليكون سهل الاستخدام وخفيف الوزن.

جدول المحتويات

TruecallerJS
- وصف
- سمات
- جدول المحتويات
- تثبيت
- استخدام سطر الأوامر
  - القيود
- الاستخدام
  - مثال بسيط
  - البحث الجماعي على أرقام هواتف متعددة
- تنصل
- المساهمة
- رخصة
- شكر وتقدير

تثبيت

يمكنك تثبيت TruecallerJS باستخدام npm:

npm install truecallerjs

لاستخدام TruecallerJS من سطر الأوامر

npm install -g truecallerjs

ملاحظة : إذا كنت تستخدم إصدارًا من truecallerjs أقدم من 1.1.2، فنوصي بالرجوع إلى وثائق truecallerjs-v1.1.2 للحصول على التعليمات. ملاحظة : إذا كنت تستخدم إصدار truecallerjs من 1.1.3 إلى 1.1.5، فيرجى الرجوع إلى وثائق truecallerjs-v1.1.5 للحصول على التعليمات.

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

لاستخدام TruecallerJS من سطر الأوامر، يمكنك تشغيل أمر truecallerjs متبوعًا بالخيارات والوسائط المطلوبة.

فيما يلي بعض الأمثلة على الخيارات المتاحة:

truecallerjs login : استخدم هذا الأمر لتسجيل الدخول إلى حساب Truecaller الخاص بك.
truecallerjs -s [number] : استخدم هذا الأمر للبحث عن رقم هاتف واسترداد اسم المتصل والمعلومات ذات الصلة.
يتم استخدام أمر truecallerjs --bulksearch, --bs لإجراء عمليات بحث عن أرقام مجمعة باستخدام خدمة Truecaller. فهو يسمح لك بالبحث عن أرقام هواتف متعددة في وقت واحد، مما يجعل من السهل معالجة مجموعات كبيرة من أرقام الهواتف في طلب واحد.
truecallerjs --bulksearch, --bs : استخدم هذا الأمر لإجراء بحث عن أرقام مجمعة.
تتضمن الخيارات الإضافية --raw و --name و --email و --json و --xml و --yaml و --text و --nc و --installationid و --verbose و --help .

على سبيل المثال:

 ~ $ truecallerjs -s +9199123456789 --json
{
     ...
     " name " : " Sumith Emmadi "
     ...
}

~ $ truecallerjs -s +9199123456789 --name
Name : Sumith Emmadi

مثال للبحث الجماعي

truecallerjs --bulksearch < phone_number_ 1> , < phone_number_ 2> , < phone_number_ 3> ,..., < phone_number_n >

استبدل <phone_number_1>, <phone_number_2>, ..., <phone_number_n> بأرقام الهواتف الفعلية التي تريد البحث عنها. افصل بين كل رقم هاتف بفاصلة.

 ~ $ truecallerjs --bs 9912345678,+14051234567,+919987654321

ملاحظة : إذا لم يتم تحديد رمز البلد لرقم هاتف، فسيتم افتراضيًا استخدام رمز البلد الخاص بك.

القيود

يرجى ملاحظة القيود التالية عند استخدام خيار --bulksearch :

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

الاستخدام

لاستخدام المشروع، ابدأ بتثبيت حزمة truecallerjs عبر npm:

npm install truecallerjs

مثال بسيط

فيما يلي مثال أساسي لكيفية إجراء بحث عادي عن رقم هاتف:

 import truecallerjs , { SearchData , Format } from "truecallerjs" ;

async function performTruecallerSearch ( ) : Promise < void > {
  const searchData : SearchData = {
    number : "9912345678" ,
    countryCode : "IN" ,
    installationId : "a1k07--Vgdfyvv_rftf5uuudhuhnkljyvvtfftjuhbuijbhug" ,
  } ;

  try {
    const response : Format = await truecallerjs . search ( searchData ) ;
    console . log ( response . json ( ) ) ;

    // Additional response methods:
    // console.log(response.xml());
    // console.log(response.yaml());
    // console.log(response.text());

    // Example of available data from the response:
    console . log ( response . getName ( ) ) ; // "Sumith Emmadi"
    console . log ( response . getAlternateName ( ) ) ; // "sumith"
    console . log ( response . getAddresses ( ) ) ; // {....}
    console . log ( response . getEmailId ( ) ) ; // [email protected]
    console . log ( response . getCountryDetails ( ) ) ; // {...}
  } catch ( error ) {
    console . error ( "Error occurred:" , error ) ;
  }
}

performTruecallerSearch ( ) ;

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

ملاحظة : تأكد من تسجيل الدخول باستخدام أمر truecallerjs login والحصول على معرف التثبيت الخاص بك باستخدام أمر truecallerjs -i .

البحث الجماعي على أرقام هواتف متعددة

تدعم حزمة truecallerjs أيضًا البحث الجماعي على أرقام هواتف متعددة:

 import truecallerjs , { BulkSearchData , Format } from "truecallerjs" ;

async function performBulkTruecallerSearch ( ) : Promise < void > {
  const countryCode : string = "IN" ;
  const installationId : string = "a1k07--Vgdfyvv_rftf5uuudhuhnkljyvvtfftjuhbuijbhug" ;
  const phoneNumbers : string = "+9912345678,+14051234567,+919987654321" ;

  try {
    const response : BulkSearchData = await truecallerjs . bulkSearch ( phoneNumbers , countryCode , installationId ) ;
    console . log ( response ) ;
  } catch ( error ) {
    console . error ( "Error occurred:" , error ) ;
  }
}

performBulkTruecallerSearch ( ) ;

في هذا المثال، يتم استخدام وظيفة truecallerjs.bulkSearch() لإجراء عمليات بحث مجمعة على أرقام هواتف متعددة. يجب أن تحتوي المعلمة phoneNumbers على أرقام الهواتف مفصولة بفواصل. يتم استخدام معلمات countryCode ومعرف installationId لتحديد رمز البلد الافتراضي ومعرف التثبيت، على التوالي.

ملاحظة : تأكد من تسجيل الدخول باستخدام أمر truecallerjs login والحصول على معرف التثبيت الخاص بك باستخدام أمر truecallerjs -i .

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

تنصل

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

لمزيد من المعلومات والدعم، يرجى الاتصال بسوميث عمادي على [email protected].

المساهمة

المساهمات في truecallerjs ليست موضع ترحيب فحسب، بل يتم تشجيعها بشدة!

git clone https://github.com/sumithemmadi/truecallerjs.git
قم بإنشاء فرع جديد لمساهمتك.
أضف المحتوى الخاص بك في المجلد المناسب أو قم بإنشاء ملف جديد.
قم بإجراء تغييراتك وادفعها إلى مستودعك المتشعب.
افتح طلب سحب موضحًا فيه طبيعة مساهمتك.

يرجى ملاحظة أن جميع المساهمات يجب أن تتوافق مع روح المستودع وأن تكون مناسبة لجميع الجماهير. لن يتم قبول المحتوى المسيء أو غير المناسب.

رخصة

TruecallerJS مفتوح المصدر ومرخص بموجب ترخيص MIT. راجع ملف الترخيص لمزيد من المعلومات.

؟ ادعمني وادعمني

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

❤️ ادعمني على جيثب